---
title: "Developing IceBox Services"
url: https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services
language: csharp
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Developing IceBox Services

Programming language: C#. Other languages: [C++](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/cpp.md), [Java](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/java.md), [JavaScript](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/php.md), [Python](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/services/icebox/developing-icebox-services/swift.md).

## The IceBox `Service` Interface

Writing an IceBox service requires implementing the [IceBox Service](https://code.zeroc.com/ice/3.8/api/csharp/api/IceBox.Service.html) interface or abstract base class.

Your service implements two methods, `start` and `stop`. IceBox calls `start` after loading the service and `stop` when shutting down a running service. An administrator can also stop and restart the service through the [service manager](https://docs.zeroc.com/ice/3.8/services/icebox/icebox-administration.md). IceBox reuses the same service object, communicator, and arguments for each restart.

The `start` method initializes the service, typically by creating an object adapter and servants. The `name` and `args` parameters supply information from the service's [configuration](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/csharp.md), and the `communicator` parameter supplies a communicator that IceBox creates for the service. Services that [share a communicator](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/csharp.md) must use distinct names for their object adapters.

`start` must return once the service is initialized, because IceBox waits for it before starting the next service and before activating its admin object.

The `stop` method must release the resources owned by the service and destroy the [object adapters](https://docs.zeroc.com/ice/3.8/runtime/dispatch/object-adapter-activation-and-deactivation/csharp.md) it created.

IceBox owns the communicator it passes to `start` and destroys it when the server shuts down.

## IceBox Service Example

The example we present here is taken from the `IceBox/Greeter` demo program.

Add a reference to the `ZeroC.IceBox` NuGet package, version 3.8.x, to your service project. This package provides the `IceBox.Service` interface.

The class definition for our service is quite straightforward:

```csharp
public class GreeterService : IceBox.Service
{
    private Ice.ObjectAdapter? _adapter;

    public void start(string name, Ice.Communicator communicator, string[] args)
    {
        Debug.Assert(_adapter is null);
        _adapter = communicator.createObjectAdapterWithEndpoints(
            "GreeterAdapter",
            "tcp -p 4061");

        _adapter.add(new Chatbot("Syd"), new Ice.Identity { name = "greeter" });
        _adapter.activate();
        Console.WriteLine("Listening on port 4061...");
    }

    public void stop()
    {
        Console.WriteLine("Shutting down...");

        Debug.Assert(_adapter is not null);
        _adapter.destroy();
        _adapter = null;
    }
}
```

The `start` method creates an object adapter “GreeterAdapter”, activates a single servant of type `Chatbot` (not shown), and activates the object adapter. The `stop` method simply destroys the object adapter.

### C# Service Entry Point

The last piece of the puzzle is the *entry point*, which the IceBox server calls to create an instance of the service.

IceBox requires a service implementation to have a public parameterless constructor or a public constructor with a single `Communicator` parameter. This is the C# entry point for IceBox: the IceBox server dynamically loads the service implementation class from an assembly and calls this public constructor to create an instance of the service.

[Configuring IceBox Services](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/csharp.md) provides more information on entry points and describes how to configure your service into an IceBox server.

## IceBox Service Failures

A service implementation can indicate a failure by throwing an exception. IceBox handles the exception according to when it occurs:

- **Initial startup** If the service's entry point or initial `start` call throws, the server terminates as described in [Starting the IceBox Server](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/csharp.md#icebox-server-failures).
- **Administrative start** If `start` throws during `ServiceManager.startService`, IceBox logs a warning, records the service as stopped, and returns normally from `startService`.
- **Administrative stop** If `stop` throws during `ServiceManager.stopService`, IceBox logs a warning, records the service as started, and returns normally from `stopService`.
- **Server shutdown** If `stop` throws, IceBox logs a warning and continues stopping the remaining services and destroying their communicators.

Because `startService` and `stopService` return normally in these cases, use `ServiceManager.isServiceRunning` to check whether the service started or stopped.

If `start` fails, the service must release resources it acquired during that attempt before propagating the exception. IceBox calls `stop` only for services it records as started.

## See Also

- [Configuring IceBox Services](https://docs.zeroc.com/ice/3.8/services/icebox/configuring-icebox-services/csharp.md)
- [Starting the IceBox Server](https://docs.zeroc.com/ice/3.8/services/icebox/starting-the-icebox-server/csharp.md)
