Skip to content

io microsphere spring cloud client service registry MultipleRegistration

github-actions[bot] edited this page Aug 3, 2026 · 10 revisions

MultipleRegistration

Type: Class | Module: microsphere-spring-cloud-commons | Package: io.microsphere.spring.cloud.client.service.registry | Since: 1.0.0

Source: microsphere-spring-cloud-commons/src/main/java/io/microsphere/spring/cloud/client/service/registry/MultipleRegistration.java

Overview

The Delegating Registration for the multiple service registration

Declaration

public class MultipleRegistration implements Registration

Author: 韩超

Version Information

  • Introduced in: 1.0.0
  • Current Project Version: 0.2.25-SNAPSHOT

Version Compatibility

This component is tested and compatible with the following Java versions:

Java Version Status
Java 17 ✅ Compatible
Java 21 ✅ Compatible
Java 25 ✅ Compatible

Examples

Method Examples

getInstanceId

DefaultRegistration registration = new DefaultRegistration();
registration.setServiceId("test-service");
MultipleRegistration multipleRegistration =
    new MultipleRegistration(List.of(registration));
MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
String instanceId = multipleRegistration.getInstanceId();

getServiceId

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
String serviceId = multipleRegistration.getServiceId();

getHost

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
String host = multipleRegistration.getHost();

getPort

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
int port = multipleRegistration.getPort();

isSecure

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
boolean secure = multipleRegistration.isSecure();

getUri

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
URI uri = multipleRegistration.getUri();

getDefaultRegistration

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
Map<String, String> metadata = multipleRegistration.getMetadata();
MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
Registration defaultReg = multipleRegistration.getDefaultRegistration();

special

MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
DefaultRegistration specific = multipleRegistration.special(DefaultRegistration.class);
Registration self = multipleRegistration.special(Registration.class);

Usage

Maven Dependency

Add the following dependency to your pom.xml:

<dependency>
    <groupId>io.github.microsphere-projects</groupId>
    <artifactId>microsphere-spring-cloud-commons</artifactId>
    <version>${microsphere-spring-cloud.version}</version>
</dependency>

Tip: Use the BOM (microsphere-spring-cloud-dependencies) for consistent version management. See the Getting Started guide.

Import

import io.microsphere.spring.cloud.client.service.registry.MultipleRegistration;

API Reference

Public Methods

Method Description
getInstanceId Constructs a new MultipleRegistration from the given collection of
getServiceId Returns the service ID from the default Registration.
getHost Returns the host from the default Registration.
getPort Returns the port from the default Registration.
isSecure Returns whether the default Registration is secure.
getUri Returns the URI from the default Registration.
getDefaultRegistration Returns the aggregated RegistrationMetaData that synchronizes metadata
special Retrieves a specific Registration by its class type. If the specified

Method Details

getInstanceId

public String getInstanceId()

Constructs a new MultipleRegistration from the given collection of Registration instances. The last registration in the collection becomes the default registration.

Example Usage

`DefaultRegistration registration = new DefaultRegistration();
registration.setServiceId("test-service");
MultipleRegistration multipleRegistration =
    new MultipleRegistration(List.of(registration));
`

getServiceId

public String getServiceId()

Returns the service ID from the default Registration.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
String serviceId = multipleRegistration.getServiceId();
`

getHost

public String getHost()

Returns the host from the default Registration.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
String host = multipleRegistration.getHost();
`

getPort

public int getPort()

Returns the port from the default Registration.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
int port = multipleRegistration.getPort();
`

isSecure

public boolean isSecure()

Returns whether the default Registration is secure.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
boolean secure = multipleRegistration.isSecure();
`

getUri

public URI getUri()

Returns the URI from the default Registration.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
URI uri = multipleRegistration.getUri();
`

getDefaultRegistration

public Registration getDefaultRegistration()

Returns the aggregated RegistrationMetaData that synchronizes metadata across all underlying Registration instances.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
Map metadata = multipleRegistration.getMetadata();
`

special

public <T extends Registration> T special(Class<T> specialClass)

Retrieves a specific Registration by its class type. If the specified class is Registration itself, returns this MultipleRegistration.

Example Usage

`MultipleRegistration multipleRegistration = new MultipleRegistration(registrations);
DefaultRegistration specific = multipleRegistration.special(DefaultRegistration.class);
Registration self = multipleRegistration.special(Registration.class);
`

See Also

  • MultipleAutoServiceRegistration
  • MultipleServiceRegistry

This documentation was auto-generated from the source code of microsphere-spring-cloud.

Home

spring-cloud-commons

spring-cloud-openfeign

Clone this wiki locally