---
title: "Slice Loaders"
url: https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders
language: java
docs_index: https://docs.zeroc.com/llms.txt
---

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

# Slice Loaders

Programming language: Java. Other languages: [C++](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/csharp.md), [JavaScript](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/js.md), [MATLAB](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/matlab.md), [PHP](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/php.md), [Python](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/python.md), [Ruby](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/ruby.md), [Swift](https://docs.zeroc.com/ice/3.8/slice/user-defined-types/classes/slice-loaders/swift.md).

When Ice unmarshals a Slice-defined class or exception, it starts by locating the mapped class and creating an instance of this class.

The abstraction that drives this locate and create process is called the Slice loader. Each communicator has a default Slice loader, implemented by Ice, that locates the generated class for a Slice type ID.

The default Slice loader of Ice for Java converts the Slice type ID into a Java class name: for the type ID `::Demo::Node`, it loads the class `Demo.Node`. It cannot locate the class for a Slice class or exception when:

- you remap either the class name or an enclosing module using the `java:identifier` metadata;
- you remap an enclosing module using the `java:package` metadata, and set neither the matching [Ice.Package.*module*](https://docs.zeroc.com/ice/3.8/property-reference/ice-properties/java.md#ice.package.module) property nor [Ice.Default.Package](https://docs.zeroc.com/ice/3.8/property-reference/ice-default-properties/java.md#ice.default.package); or
- you assign a compact ID to the class.

For these classes, install a [ClassSliceLoader](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/ClassSliceLoader.html) created from the generated classes as your custom Slice loader (see below); the communicator keeps using its default Slice loader for all other classes:

```java
var initData = new InitializationData();
initData.sliceLoader = new ClassSliceLoader(Compact.class, CompactExt.class);
```

## Custom Slice Loaders

You can install your own custom Slice loader on a communicator to create instances of your own classes, typically classes derived from the generated classes, during unmarshaling. The communicator calls your Slice loader first, and falls back on its default Slice loader when your Slice loader doesn't create an instance.

The communicator calls your Slice loader for both Slice classes and Slice exceptions.

A custom Slice loader implements the `SliceLoader` functional interface. You install it by setting the `sliceLoader` field of [InitializationData](https://code.zeroc.com/ice/3.8/api/java/com.zeroc.ice/com/zeroc/Ice/InitializationData.html):

```java
var initData = new InitializationData();
initData.sliceLoader = typeId -> "::Demo::Node".equals(typeId) ? new MyNode() : null;
try (var communicator = new Communicator(initData)) {
    ...
}
```

## See Also

- [Type IDs](https://docs.zeroc.com/ice/3.8/slice/type-ids.md)
