org.seedstack.business.domain.DomainRegistry Maven / Gradle / Ivy
/*
* Copyright © 2013-2024, The SeedStack authors
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
package org.seedstack.business.domain;
import java.lang.annotation.Annotation;
import java.lang.reflect.Type;
import org.seedstack.business.Service;
/**
* The domain registry provides programmatic access to domain objects.
*
* Usage for a class without generic parameter:
*
* MyPolicy policy = domainRegistry.getPolicy(MyPolicy.class,"qualifier");
*
*
* Usage for a class with generic parameter(s):
*
* AnotherPolicy<MyClient<Long>> policy = domainRegistry.getPolicy(
* new TypeOf<AnotherPolicy<MyClient<Long>>>(){},
* "qualifier"
* );
*
*
* Note that generics are specified with a {@link Type} instance. In the example above,
* SeedStack {@code TypeOf} is used to capture generics and provide a {@link Type} instance but any
* other implementation can be used.
*/
public interface DomainRegistry {
/**
* Get the {@link Repository} for an aggregate root.
*
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param aggregateRootClass the aggregate root class.
* @param idClass the aggregate root identifier class.
* @return an instance of the repository.
*/
, I> Repository getRepository(Class aggregateRootClass, Class idClass);
/**
* Get the {@link Repository} for an aggregate root and a qualifier.
*
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param aggregateRootClass the aggregate root class.
* @param idClass the aggregate root identifier class.
* @param qualifier the repository qualifier.
* @return an instance of the repository.
*/
, I> Repository getRepository(Class aggregateRootClass, Class idClass,
Annotation qualifier);
/**
* Get the {@link Repository} for an aggregate root and a qualifier.
*
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param aggregateRootClass the aggregate root class.
* @param idClass the aggregate root identifier class.
* @param qualifier the repository qualifier.
* @return an instance of the repository.
*/
, I> Repository getRepository(Class aggregateRootClass, Class idClass,
Class qualifier);
/**
* Get the {@link Repository} for an aggregate root and a qualifier.
*
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param aggregateRootClass the aggregate root class.
* @param idClass the aggregate root identifier class.
* @param qualifier the repository qualifier.
* @return an instance of the repository.
*/
, I> Repository getRepository(Class aggregateRootClass, Class idClass,
String qualifier);
/**
* Get a {@link Repository} from the domain.
*
* @param the type of the repository.
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param repositoryType the full generic type.
* @return an instance of the repository.
*/
, A extends AggregateRoot, I> R getRepository(Type repositoryType);
/**
* Get a {@link Repository} from the domain.
*
* @param the type of the repository.
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param repositoryType the full generic type.
* @param qualifier the repository qualifier.
* @return an instance of the repository.
*/
, A extends AggregateRoot, I> R getRepository(Type repositoryType,
Class qualifier);
/**
* Get a {@link Repository} from the domain.
*
* @param the type of the repository.
* @param the type of the aggregate root.
* @param the type of the aggregate root identifier.
* @param repositoryType the full generic type.
* @param qualifier the repository qualifier.
* @return an instance of the repository.
*/
, A extends AggregateRoot, I> R getRepository(Type repositoryType, String qualifier);
/**
* Get the {@link Factory} for an aggregate root.
*
* @param the type of the producible object.
* @param producibleClass the producible class.
* @return an instance of the factory.
*/
Factory
getFactory(Class
producibleClass);
/**
* Get the {@link Factory} with a qualifier for an aggregate root.
*
* @param
the type of the producible object.
* @param producibleClass the producible class.
* @param qualifier the factory qualifier.
* @return an instance of the factory.
*/
Factory
getFactory(Class
producibleClass, Class qualifier);
/**
* Get the {@link Factory} with a qualifier for an aggregate root.
*
* @param
the type of the producible object.
* @param producibleClass the producible class.
* @param qualifier the factory qualifier.
* @return an instance of the factory.
*/
Factory
getFactory(Class
producibleClass, String qualifier);
/**
* Get a {@link Factory} from the domain.
*
* @param the type of the factory.
* @param the type of the producible object.
* @param factoryType the capture of the full generic type.
* @return an instance of the factory.
*/
, P extends Producible> F getFactory(Type factoryType);
/**
* Get a {@link Factory} from the domain.
*
* @param the type of the factory.
* @param the type of the producible object.
* @param factoryType the full generic type.
* @param qualifier the factory qualifier.
* @return an instance of the factory.
*/
, P extends Producible> F getFactory(Type factoryType, Class qualifier);
/**
* Get a {@link Factory} from the domain.
*
* @param the type of the factory.
* @param the type of the producible object.
* @param factoryType the full generic type.
* @param qualifier the factory qualifier.
* @return an instance of the factory.
*/
, P extends Producible> F getFactory(Type factoryType, String qualifier);
/**
* Get a {@link Service} from the domain.
*
* @param the type of the service.
* @param serviceClass the class of the service interface.
* @return an instance of the service.
*/
S getService(Class serviceClass);
/**
* Get a {@link Service} with a qualifier from the domain.
*
* @param the type of the service.
* @param serviceClass the class of the service interface.
* @param qualifier the service qualifier.
* @return an instance of the service.
*/
S getService(Class serviceClass, Class qualifier);
/**
* Get a {@link Service} with a qualifier from the domain.
*
* @param the type of the service.
* @param serviceClass the class of the service interface.
* @param qualifier the service qualifier.
* @return an instance of the service.
*/
S getService(Class serviceClass, String qualifier);
/**
* Get a {@link Service} from the domain.
*
* @param the type of the service.
* @param serviceType the full generic type.
* @return an instance of the service.
*/
S getService(Type serviceType);
/**
* Get a {@link Service} from the domain.
*
* @param the type of the service.
* @param serviceType the full generic type.
* @param qualifier the service qualifier.
* @return an instance of the service.
*/
S getService(Type serviceType, Class qualifier);
/**
* Get a {@link Service} from the domain.
*
* @param the type of the service.
* @param serviceType the full generic type.
* @param qualifier the service qualifier.
* @return an instance of the service.
*/
S getService(Type serviceType, String qualifier);
/**
* Get a {@link DomainPolicy} from the domain.
*
* @param the type of the policy.
* @param policyClass the policy class.
* @return an instance of the domain policy.
*/
P getPolicy(Class
policyClass);
/**
* Get a {@link DomainPolicy} with a qualifier from the domain.
*
* @param
the type of the policy.
* @param policyClass the policy class.
* @param qualifier the policy qualifier.
* @return an instance of the domain policy.
*/
P getPolicy(Class
policyClass, Class qualifier);
/**
* Get a {@link DomainPolicy} with a qualifier from the domain.
*
* @param
the type of the policy.
* @param policyClass the policy class.
* @param qualifier the policy qualifier.
* @return an instance of the domain policy.
*/
P getPolicy(Class
policyClass, String qualifier);
/**
* Get a {@link DomainPolicy} from the domain.
*
* @param
the type of the policy.
* @param policyType the full generic type.
* @return an instance of the domain policy.
*/
P getPolicy(Type policyType);
/**
* Get a {@link DomainPolicy} from the domain.
*
* @param
the type of the policy.
* @param policyType the full generic type.
* @param qualifier the policy qualifier.
* @return an instance of the domain policy.
*/
P getPolicy(Type policyType, Class qualifier);
/**
* Get a {@link DomainPolicy} from the domain.
*
* @param
the type of the policy.
* @param policyType the full generic type.
* @param qualifier the policy qualifier.
* @return an instance of the domain policy.
*/
P getPolicy(Type policyType, String qualifier);
}