SteamWar/Paper
9
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

SPIGOT-2540: Add nullability annotations to entire Bukkit API

Browse Source 
By: Darkyenus <darkyenus@gmail.com>
This commit is contained in:
Bukkit/Spigot
2019-03-13 17:42:57 +11:00
parent e069a80fd8
commit 416c865476
565 changed files with 5372 additions and 2008 deletions
Download Patch File Download Diff File Expand all files Collapse all files

28
paper-api/src/main/java/org/bukkit/plugin/ServicesManager.java
View File

@@ -1,5 +1,8 @@
package org.bukkit.plugin;
import org.jetbrains.annotations.NotNull;
import org.jetbrains.annotations.Nullable;
import java.util.Collection;
import java.util.List;
@@ -22,14 +25,14 @@ public interface ServicesManager {
* @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);
public <T> void register(@NotNull Class<T> service, @NotNull T provider, @NotNull Plugin plugin, @NotNull ServicePriority priority);
/**
* Unregister all the providers registered by a particular plugin.
*
* @param plugin The plugin
*/
public void unregisterAll(Plugin plugin);
public void unregisterAll(@NotNull Plugin plugin);
/**
* Unregister a particular provider for a particular service.
@@ -37,14 +40,14 @@ public interface ServicesManager {
* @param service The service interface
* @param provider The service provider implementation
*/
public void unregister(Class<?> service, Object provider);
public void unregister(@NotNull Class<?> service, @NotNull Object provider);
/**
* Unregister a particular provider.
*
* @param provider The service provider implementation
*/
public void unregister(Object provider);
public void unregister(@NotNull Object provider);
/**
* Queries for a provider. This may return if no provider has been
@@ -54,7 +57,8 @@ public interface ServicesManager {
* @param service The service interface
* @return provider or null
*/
public <T> T load(Class<T> service);
@Nullable
public <T> T load(@NotNull Class<T> service);
/**
* Queries for a provider registration. This may return if no provider
@@ -64,15 +68,17 @@ public interface ServicesManager {
* @param service The service interface
* @return provider registration or null
*/
public <T> RegisteredServiceProvider<T> getRegistration(Class<T> service);
@Nullable
public <T> RegisteredServiceProvider<T> getRegistration(@NotNull Class<T> service);
/**
* Get registrations of providers for a plugin.
*
* @param plugin The plugin
* @return provider registration or null
* @return provider registrations
*/
public List<RegisteredServiceProvider<?>> getRegistrations(Plugin plugin);
@NotNull
public List<RegisteredServiceProvider<?>> getRegistrations(@NotNull Plugin plugin);
/**
* Get registrations of providers for a service. The returned list is
@@ -82,7 +88,8 @@ public interface ServicesManager {
* @param service The service interface
* @return list of registrations
*/
public <T> Collection<RegisteredServiceProvider<T>> getRegistrations(Class<T> service);
@NotNull
public <T> Collection<RegisteredServiceProvider<T>> getRegistrations(@NotNull Class<T> service);
/**
* Get a list of known services. A service is known if it has registered
@@ -90,6 +97,7 @@ public interface ServicesManager {
*
* @return list of known services
*/
@NotNull
public Collection<Class<?>> getKnownServices();
/**
@@ -101,6 +109,6 @@ public interface ServicesManager {
* @param service service to check
* @return whether there has been a registered provider
*/
public <T> boolean isProvidedFor(Class<T> service);
public <T> boolean isProvidedFor(@NotNull Class<T> service);
}