Line endings. Don't make me yell at you.
By: Dinnerbone <dinnerbone@dinnerbone.com>
This commit is contained in:
@@ -1,110 +1,110 @@
|
||||
package org.bukkit.plugin;
|
||||
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* Manages services and service providers. Services are an interface specifying
|
||||
* a list of methods that a provider must implement. Providers are
|
||||
* implementations of these services. A provider can be queried from the
|
||||
* services manager in order to use a service (if one is available). If
|
||||
* multiple plugins register a service, then the service with the highest
|
||||
* priority takes precedence.
|
||||
*
|
||||
* @author sk89q
|
||||
*/
|
||||
public interface ServicesManager {
|
||||
|
||||
/**
|
||||
* Register a provider of a service.
|
||||
*
|
||||
* @param <T> Provider
|
||||
* @param service service class
|
||||
* @param provider provider to register
|
||||
* @param plugin plugin with the provider
|
||||
* @param priority priority of the provider
|
||||
*/
|
||||
public <T> void register(Class<T> service, T provider, Plugin plugin,
|
||||
ServicePriority priority);
|
||||
|
||||
/**
|
||||
* Unregister all the providers registered by a particular plugin.
|
||||
*
|
||||
* @param plugin
|
||||
*/
|
||||
public void unregisterAll(Plugin plugin);
|
||||
|
||||
/**
|
||||
* Unregister a particular provider for a particular service.
|
||||
*
|
||||
* @param service
|
||||
* @param provider
|
||||
*/
|
||||
public void unregister(Class<?> service, Object provider);
|
||||
|
||||
/**
|
||||
* Unregister a particular provider.
|
||||
*
|
||||
* @param provider
|
||||
*/
|
||||
public void unregister(Object provider);
|
||||
|
||||
/**
|
||||
* Queries for a provider. This may return if no provider has been
|
||||
* registered for a service. The highest priority provider is returned.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return provider or null
|
||||
*/
|
||||
public <T> T load(Class<T> service);
|
||||
|
||||
/**
|
||||
* Queries for a provider registration. This may return if no provider
|
||||
* has been registered for a service.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return provider registration or null
|
||||
*/
|
||||
public <T> RegisteredServiceProvider<T> getRegistration(Class<T> service);
|
||||
|
||||
/**
|
||||
* Get registrations of providers for a plugin.
|
||||
*
|
||||
* @param plugin
|
||||
* @return provider registration or null
|
||||
*/
|
||||
public List<RegisteredServiceProvider<?>> getRegistrations(Plugin plugin);
|
||||
|
||||
/**
|
||||
* Get registrations of providers for a service. The returned list is
|
||||
* unmodifiable.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return list of registrations
|
||||
*/
|
||||
public <T> Collection<RegisteredServiceProvider<T>> getRegistrations(
|
||||
Class<T> service);
|
||||
|
||||
/**
|
||||
* Get a list of known services. A service is known if it has registered
|
||||
* providers for it.
|
||||
*
|
||||
* @return list of known services
|
||||
*/
|
||||
public Collection<Class<?>> getKnownServices();
|
||||
|
||||
/**
|
||||
* Returns whether a provider has been registered for a service. Do not
|
||||
* check this first only to call <code>load(service)</code> later, as that
|
||||
* would be a non-thread safe situation.
|
||||
*
|
||||
* @param <T> service
|
||||
* @param service service to check
|
||||
* @return whether there has been a registered provider
|
||||
*/
|
||||
public <T> boolean isProvidedFor(Class<T> service);
|
||||
|
||||
package org.bukkit.plugin;
|
||||
|
||||
import java.util.Collection;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* Manages services and service providers. Services are an interface specifying
|
||||
* a list of methods that a provider must implement. Providers are
|
||||
* implementations of these services. A provider can be queried from the
|
||||
* services manager in order to use a service (if one is available). If
|
||||
* multiple plugins register a service, then the service with the highest
|
||||
* priority takes precedence.
|
||||
*
|
||||
* @author sk89q
|
||||
*/
|
||||
public interface ServicesManager {
|
||||
|
||||
/**
|
||||
* Register a provider of a service.
|
||||
*
|
||||
* @param <T> Provider
|
||||
* @param service service class
|
||||
* @param provider provider to register
|
||||
* @param plugin plugin with the provider
|
||||
* @param priority priority of the provider
|
||||
*/
|
||||
public <T> void register(Class<T> service, T provider, Plugin plugin,
|
||||
ServicePriority priority);
|
||||
|
||||
/**
|
||||
* Unregister all the providers registered by a particular plugin.
|
||||
*
|
||||
* @param plugin
|
||||
*/
|
||||
public void unregisterAll(Plugin plugin);
|
||||
|
||||
/**
|
||||
* Unregister a particular provider for a particular service.
|
||||
*
|
||||
* @param service
|
||||
* @param provider
|
||||
*/
|
||||
public void unregister(Class<?> service, Object provider);
|
||||
|
||||
/**
|
||||
* Unregister a particular provider.
|
||||
*
|
||||
* @param provider
|
||||
*/
|
||||
public void unregister(Object provider);
|
||||
|
||||
/**
|
||||
* Queries for a provider. This may return if no provider has been
|
||||
* registered for a service. The highest priority provider is returned.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return provider or null
|
||||
*/
|
||||
public <T> T load(Class<T> service);
|
||||
|
||||
/**
|
||||
* Queries for a provider registration. This may return if no provider
|
||||
* has been registered for a service.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return provider registration or null
|
||||
*/
|
||||
public <T> RegisteredServiceProvider<T> getRegistration(Class<T> service);
|
||||
|
||||
/**
|
||||
* Get registrations of providers for a plugin.
|
||||
*
|
||||
* @param plugin
|
||||
* @return provider registration or null
|
||||
*/
|
||||
public List<RegisteredServiceProvider<?>> getRegistrations(Plugin plugin);
|
||||
|
||||
/**
|
||||
* Get registrations of providers for a service. The returned list is
|
||||
* unmodifiable.
|
||||
*
|
||||
* @param <T>
|
||||
* @param service
|
||||
* @return list of registrations
|
||||
*/
|
||||
public <T> Collection<RegisteredServiceProvider<T>> getRegistrations(
|
||||
Class<T> service);
|
||||
|
||||
/**
|
||||
* Get a list of known services. A service is known if it has registered
|
||||
* providers for it.
|
||||
*
|
||||
* @return list of known services
|
||||
*/
|
||||
public Collection<Class<?>> getKnownServices();
|
||||
|
||||
/**
|
||||
* Returns whether a provider has been registered for a service. Do not
|
||||
* check this first only to call <code>load(service)</code> later, as that
|
||||
* would be a non-thread safe situation.
|
||||
*
|
||||
* @param <T> service
|
||||
* @param service service to check
|
||||
* @return whether there has been a registered provider
|
||||
*/
|
||||
public <T> boolean isProvidedFor(Class<T> service);
|
||||
|
||||
}
|
||||
Reference in New Issue
Block a user