From b0b94aee56dd06e81335b89a8536f6ca6c3842d9 Mon Sep 17 00:00:00 2001 From: Senmori Date: Tue, 27 Feb 2018 21:42:48 -0500 Subject: Update plugin-annotations to 1.12 and Java 8. --- .../org/bukkit/plugin/java/annotation/Author.java | 18 -- .../bukkit/plugin/java/annotation/Commands.java | 52 ----- .../bukkit/plugin/java/annotation/DependsOn.java | 17 -- .../bukkit/plugin/java/annotation/Description.java | 17 -- .../bukkit/plugin/java/annotation/LoadBefore.java | 17 -- .../org/bukkit/plugin/java/annotation/LoadOn.java | 18 -- .../bukkit/plugin/java/annotation/LogPrefix.java | 16 -- .../org/bukkit/plugin/java/annotation/Main.java | 55 ----- .../org/bukkit/plugin/java/annotation/Name.java | 18 -- .../bukkit/plugin/java/annotation/Permissions.java | 50 ----- .../java/annotation/PluginAnnotationProcessor.java | 223 ++++++++++++++------- .../plugin/java/annotation/SoftDependsOn.java | 17 -- .../plugin/java/annotation/UsesDatabase.java | 13 -- .../org/bukkit/plugin/java/annotation/Version.java | 20 -- .../org/bukkit/plugin/java/annotation/Website.java | 17 -- .../plugin/java/annotation/command/Command.java | 48 +++++ .../plugin/java/annotation/command/Commands.java | 20 ++ .../java/annotation/dependency/Dependency.java | 19 ++ .../java/annotation/dependency/DependsOn.java | 20 ++ .../java/annotation/dependency/LoadBefore.java | 21 ++ .../annotation/dependency/LoadBeforePlugins.java | 17 ++ .../java/annotation/dependency/SoftDependency.java | 22 ++ .../java/annotation/dependency/SoftDependsOn.java | 23 +++ .../annotation/permission/ChildPermission.java | 18 ++ .../java/annotation/permission/Permission.java | 40 ++++ .../java/annotation/permission/Permissions.java | 20 ++ .../plugin/java/annotation/plugin/Description.java | 21 ++ .../plugin/java/annotation/plugin/LoadOn.java | 22 ++ .../plugin/java/annotation/plugin/LogPrefix.java | 20 ++ .../bukkit/plugin/java/annotation/plugin/Main.java | 62 ++++++ .../bukkit/plugin/java/annotation/plugin/Name.java | 23 +++ .../plugin/java/annotation/plugin/Plugin.java | 24 +++ .../java/annotation/plugin/UsesDatabase.java | 20 ++ .../plugin/java/annotation/plugin/Version.java | 26 +++ .../plugin/java/annotation/plugin/Website.java | 20 ++ .../java/annotation/plugin/author/Author.java | 22 ++ .../java/annotation/plugin/author/Authors.java | 14 ++ 37 files changed, 687 insertions(+), 423 deletions(-) delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Author.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Commands.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/DependsOn.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Description.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/LoadBefore.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/LoadOn.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/LogPrefix.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Main.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Name.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Permissions.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/SoftDependsOn.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/UsesDatabase.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Version.java delete mode 100644 src/main/java/org/bukkit/plugin/java/annotation/Website.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/command/Command.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/command/Commands.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/Dependency.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/DependsOn.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBefore.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBeforePlugins.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependency.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependsOn.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/permission/ChildPermission.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/permission/Permission.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/permission/Permissions.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Description.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/LoadOn.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/LogPrefix.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Main.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Name.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Plugin.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/UsesDatabase.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Version.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/Website.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Author.java create mode 100644 src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Authors.java (limited to 'src/main') diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Author.java b/src/main/java/org/bukkit/plugin/java/annotation/Author.java deleted file mode 100644 index d226d7d..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Author.java +++ /dev/null @@ -1,18 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the author(s) of the plugin. Translates to {@code author} - * in plugin.yml if a single author, otherwise {@code authors} - */ - -@Target(ElementType.TYPE) -public @interface Author { - - public String[] value(); - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Commands.java b/src/main/java/org/bukkit/plugin/java/annotation/Commands.java deleted file mode 100644 index c730b59..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Commands.java +++ /dev/null @@ -1,52 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents a list of this plugin's registered commands. - */ - -@Target(ElementType.TYPE) -public @interface Commands { // TODO: in java 8, make repeatable. - - public Cmd[] value(); - - @Target({}) - public static @interface Cmd { - - /** - * This command's name. - */ - public String value(); - - /** - * This command's description. - */ - - public String desc() default ""; - - /** - * This command's aliases. - */ - public String[] aliases() default {}; - - /** - * This command's permission node. - */ - public String permission() default ""; - - /** - * This command's permission-check-fail message. - */ - public String permissionMessage() default ""; - - /** - * This command's usage message. - */ - public String usage() default ""; - } - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/DependsOn.java b/src/main/java/org/bukkit/plugin/java/annotation/DependsOn.java deleted file mode 100644 index 892a267..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/DependsOn.java +++ /dev/null @@ -1,17 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the plugin's hard dependencies. - */ - -@Target(ElementType.TYPE) -public @interface DependsOn { - - public String[] value(); - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Description.java b/src/main/java/org/bukkit/plugin/java/annotation/Description.java deleted file mode 100644 index 4595d06..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Description.java +++ /dev/null @@ -1,17 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents a short description for the plugin. - */ - -@Target(ElementType.TYPE) -public @interface Description { - - public String value(); - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/LoadBefore.java b/src/main/java/org/bukkit/plugin/java/annotation/LoadBefore.java deleted file mode 100644 index d0802f4..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/LoadBefore.java +++ /dev/null @@ -1,17 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the plugins this plugin should be loaded before - */ - -@Target(ElementType.TYPE) -public @interface LoadBefore { - - public String[] value(); - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/LoadOn.java b/src/main/java/org/bukkit/plugin/java/annotation/LoadOn.java deleted file mode 100644 index 9e5372d..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/LoadOn.java +++ /dev/null @@ -1,18 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import org.bukkit.plugin.PluginLoadOrder; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the optional load order of the plugin. - */ - -@Target(ElementType.TYPE) -public @interface LoadOn { - - public PluginLoadOrder value(); -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/LogPrefix.java b/src/main/java/org/bukkit/plugin/java/annotation/LogPrefix.java deleted file mode 100644 index e8d6ed4..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/LogPrefix.java +++ /dev/null @@ -1,16 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the prefix used for the plugin's log entries, defaults to plugin name. - */ - -@Target(ElementType.TYPE) -public @interface LogPrefix { - - public String value(); -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Main.java b/src/main/java/org/bukkit/plugin/java/annotation/Main.java deleted file mode 100644 index ebef467..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Main.java +++ /dev/null @@ -1,55 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Marks this class (which must subclass JavaPlugin) as this plugin's main class. - *

- * This class is part of the plugin annotation framework that automates plugin.yml. - *

- * Example: - * 

- * {@literal @}Main
- * {@literal @}Name("Test")
- * {@literal @}Version("v1.0")
- * {@literal @}Description("A test plugin.")
- * {@literal @}LoadOn(PluginLoadOrder.POSTWORLD)
- * {@literal @}Author("md_5")
- * {@literal @}Website("spigotmc.org")
- * {@literal @}UsesDatabase
- * {@literal @}DependsOn({"WorldEdit", "Towny"})
- * {@literal @}SoftDependsOn("Vault")
- * {@literal @}LogPrefix("Testing")
- * {@literal @}LoadBefore("Essentials")
- * {@literal @}Commands({
- *     {@literal @}Cmd(
- *         value = "foo",
- *         desc = "Foo command",
- *         aliases = {"foobar", "fubar"},
- *         permission = "test.foo",
- *         permissionMessage = "You do not have permission!",
- *         usage = "/ [test|stop]"
- *     ),
- *     {@literal @}Cmd("bar")
- * })
- * {@literal @}Permissions({
- *     {@literal @}Perm(
- *         value = "test.foo",
- *         desc = "Allows foo command",
- *         defaultValue = PermissionDefault.OP,
- *     ),
- *     {@literal @}Perm(
- *         value = "test.*",
- *         desc = "Wildcard perm",
- *         defaultValue = PermissionDefault.OP,
- *         children = {"test.foo"}
- *     )
- * })
- * public class Test extends JavaPlugin { ... }
- * 
- *
- */ - -@Target(ElementType.TYPE) -public @interface Main {} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Name.java b/src/main/java/org/bukkit/plugin/java/annotation/Name.java deleted file mode 100644 index 2ef196b..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Name.java +++ /dev/null @@ -1,18 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the name of the plugin. - *

- * If not present in a class annotated with {@link Main} the name defaults to Class.getSimpleName() and will emmit a warning. - */ - -@Target(ElementType.TYPE) -public @interface Name { - - public String value(); -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Permissions.java b/src/main/java/org/bukkit/plugin/java/annotation/Permissions.java deleted file mode 100644 index c6097c3..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Permissions.java +++ /dev/null @@ -1,50 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import org.bukkit.permissions.PermissionDefault; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents a list of this plugin's registered permissions. - */ - -@Target(ElementType.TYPE) -public @interface Permissions { // TODO: in java 8, make repeatable. - - public Perm[] value(); - - @Target({}) - public static @interface Perm { - - /** - * This perm's name. - */ - public String value(); - - /** - * This perm's description. - */ - - public String desc() default ""; - - /** - * This perm's default. - */ - public PermissionDefault defaultValue() default PermissionDefault.OP; - - /** - * This perm's child nodes - */ - public String[] children() default {}; - - /** - * This perms's negated child nodes - */ - public String[] antichildren() default {}; - - } - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/PluginAnnotationProcessor.java b/src/main/java/org/bukkit/plugin/java/annotation/PluginAnnotationProcessor.java index 9266c97..9557b79 100644 --- a/src/main/java/org/bukkit/plugin/java/annotation/PluginAnnotationProcessor.java +++ b/src/main/java/org/bukkit/plugin/java/annotation/PluginAnnotationProcessor.java @@ -1,163 +1,220 @@ package org.bukkit.plugin.java.annotation; -import org.bukkit.plugin.PluginLoadOrder; +import com.google.common.collect.Lists; +import com.google.common.collect.Maps; import org.bukkit.plugin.java.JavaPlugin; +import org.bukkit.plugin.java.annotation.command.Command; +import org.bukkit.plugin.java.annotation.dependency.Dependency; +import org.bukkit.plugin.java.annotation.dependency.LoadBefore; +import org.bukkit.plugin.java.annotation.dependency.SoftDependency; +import org.bukkit.plugin.java.annotation.permission.ChildPermission; +import org.bukkit.plugin.java.annotation.permission.Permission; +import org.bukkit.plugin.java.annotation.plugin.Description; +import org.bukkit.plugin.java.annotation.plugin.LoadOn; +import org.bukkit.plugin.java.annotation.plugin.LogPrefix; +import org.bukkit.plugin.java.annotation.plugin.Plugin; +import org.bukkit.plugin.java.annotation.plugin.UsesDatabase; +import org.bukkit.plugin.java.annotation.plugin.Website; +import org.bukkit.plugin.java.annotation.plugin.author.Author; +import org.yaml.snakeyaml.DumperOptions; import org.yaml.snakeyaml.Yaml; +import org.yaml.snakeyaml.nodes.Tag; -import javax.annotation.processing.*; + +import javax.annotation.processing.AbstractProcessor; +import javax.annotation.processing.RoundEnvironment; +import javax.annotation.processing.SupportedAnnotationTypes; +import javax.annotation.processing.SupportedSourceVersion; import javax.lang.model.SourceVersion; import javax.lang.model.element.Element; import javax.lang.model.element.Modifier; import javax.lang.model.element.PackageElement; import javax.lang.model.element.TypeElement; import javax.lang.model.type.TypeMirror; +import javax.swing.text.DateFormatter; import javax.tools.Diagnostic; import javax.tools.FileObject; import javax.tools.StandardLocation; import java.io.IOException; -import java.io.StringWriter; +import java.io.InputStream; import java.io.Writer; import java.lang.annotation.Annotation; import java.lang.reflect.Method; import java.text.DateFormat; import java.text.SimpleDateFormat; +import java.time.LocalDateTime; +import java.time.format.DateTimeFormatter; import java.util.Date; -import java.util.HashMap; +import java.util.List; +import java.util.Locale; import java.util.Map; import java.util.Set; @SupportedAnnotationTypes("org.bukkit.plugin.java.annotation.*") -@SupportedSourceVersion(SourceVersion.RELEASE_6) +@SupportedSourceVersion(SourceVersion.RELEASE_8) public class PluginAnnotationProcessor extends AbstractProcessor { private boolean hasMainBeenFound = false; - private static final DateFormat dFormat = new SimpleDateFormat("yyyy/MM/dd HH:mm:ss"); + private static final DateTimeFormatter dFormat = DateTimeFormatter.ofPattern("yyyy/MM/dd HH:mm:ss", Locale.ENGLISH); @Override public boolean process(Set annots, RoundEnvironment rEnv) { Element main = null; - for(Element el : rEnv.getElementsAnnotatedWith(Main.class)) { - if(main != null){ - raiseError("More than one class with @Main found, aborting!"); - return false; - } - main = el; - } + hasMainBeenFound = false; - if(main == null) return false; + Set elements = rEnv.getElementsAnnotatedWith(Plugin.class); + if(elements.size() > 1) { + raiseError("Found more than one plugin main class"); + return false; + } + if(elements.isEmpty()) { + return false; + } if(hasMainBeenFound){ - raiseError("More than one class with @Main found, aborting!"); + raiseError("The plugin class has already been located, aborting!"); return false; } + main = elements.iterator().next(); hasMainBeenFound = true; TypeElement mainType; if(main instanceof TypeElement){ mainType = (TypeElement) main; } else { - raiseError("Element annotated with @Main is not a type!"); + raiseError("Element annotated with @Main is not a type!", main); return false; } if(!(mainType.getEnclosingElement() instanceof PackageElement) && !mainType.getModifiers().contains(Modifier.STATIC)){ - raiseError("Element annotated with @Main is not top-level or static nested!"); + raiseError("Element annotated with @Main is not top-level or static nested!", mainType); return false; } if(!processingEnv.getTypeUtils().isSubtype(mainType.asType(), fromClass(JavaPlugin.class))){ - raiseError("Class annotated with @Main is not an subclass of JavaPlugin!"); + raiseError("Class annotated with @Main is not an subclass of JavaPlugin!", mainType); } - Map yml = new HashMap(); + Map yml = Maps.newLinkedHashMap(); // linked so we can maintain the same output into file for sanity + // populate mainName final String mainName = mainType.getQualifiedName().toString(); - yml.put("main", mainName); + yml.put("main", mainName); // always override this so we make sure the main class name is correct - processAndPut(yml, "name", mainType, mainName.substring(mainName.lastIndexOf('.') + 1), Name.class, String.class); + // populate plugin name + processAndPut(yml, "name", mainType, mainName.substring(mainName.lastIndexOf('.') + 1), Plugin.class, String.class, "name"); - processAndPut(yml, "version", mainType, Version.DEFAULT_VERSION, Version.class, String.class); + // populate version + processAndPut(yml, "version", mainType, Plugin.DEFAULT_VERSION, Plugin.class, String.class, "version"); - processAndPut(yml, "description", mainType, null, Description.class, String.class); + // populate plugin description + processAndPut(yml, "description", mainType, null, Description.class, String.class, "desc"); - processAndPut(yml, "load", mainType, null, LoadOn.class, String.class); + // populate plugin load order + processAndPut(yml, "load", mainType, null, LoadOn.class, String.class,"loadOn"); - { - String[] authors = process(mainType, new String[0], Author.class, String[].class); - switch(authors.length) { - case 0: break; - case 1: yml.put("author", authors[0]); break; - default: yml.put("authors", authors); break; - } + // authors + Author[] authors = mainType.getAnnotationsByType(Author.class); + List authorMap = Lists.newArrayList(); + for(Author auth : authors) { + authorMap.add(auth.name()); + } + if(authorMap.size() > 1) { + yml.put("authors", authorMap); + } else if(authorMap.size() == 1) { + yml.put("author", authorMap.iterator().next()); } - processAndPut(yml, "website", mainType, null, Website.class, String.class); - - if(mainType.getAnnotation(UsesDatabase.class) != null) yml.put("database", true); - - processAndPut(yml, "depend", mainType, null, DependsOn.class, String[].class); - - processAndPut(yml, "softdepend", mainType, null, SoftDependsOn.class, String[].class); - - processAndPut(yml, "prefix", mainType, null, LogPrefix.class, String.class); + // website + processAndPut(yml, "website", mainType, null, Website.class, String.class, "url"); - processAndPut(yml, "loadbefore", mainType, null, LoadBefore.class, String[].class); + // prefix + processAndPut(yml, "prefix", mainType, null, LogPrefix.class, String.class, "prefix"); - Commands.Cmd[] commands = process(mainType, new Commands.Cmd[0], Commands.class, Commands.Cmd[].class); + // dependencies + Dependency[] dependencies = mainType.getAnnotationsByType(Dependency.class); + List hardDependencies = Lists.newArrayList(); + for(Dependency dep : dependencies) { + hardDependencies.add(dep.plugin()); + } + if(!hardDependencies.isEmpty()) yml.putIfAbsent("depend", hardDependencies); - Map commandMap = new HashMap(); + // soft-dependencies + SoftDependency[] softDependencies = mainType.getAnnotationsByType(SoftDependency.class); + String[] softDepArr = new String[softDependencies.length]; + for(int i = 0; i < softDependencies.length; i++) { + softDepArr[i] = softDependencies[i].plugin(); + } + if(softDepArr.length > 0) yml.putIfAbsent("softdepend", softDepArr); - for(Commands.Cmd cmd : commands) { - String name = cmd.value(); - Map desc = new HashMap(); - if(!cmd.desc().isEmpty()) desc.put("description", cmd.desc()); - if(cmd.aliases().length != 0) desc.put("aliases", cmd.aliases()); - if(!cmd.permission().isEmpty()) desc.put("permission", cmd.permission()); - if(!cmd.permissionMessage().isEmpty()) desc.put("permission-message", cmd.permissionMessage()); - if(!cmd.usage().isEmpty()) desc.put("usage", cmd.usage()); + // load-before + LoadBefore[] loadBefore = mainType.getAnnotationsByType(LoadBefore.class); + String[] loadBeforeArr = new String[loadBefore.length]; + for(int i = 0; i < loadBefore.length; i++) { + loadBeforeArr[i] = loadBefore[i].plugin(); + } + if(loadBeforeArr.length > 0) yml.putIfAbsent("loadbefore", loadBeforeArr); + + // commands + Command[] commands = mainType.getAnnotationsByType(Command.class); + Map commandMap = Maps.newLinkedHashMap(); + for(Command command : commands) { + Map desc = Maps.newLinkedHashMap(); + String name = command.name(); + if(!command.desc().isEmpty()) desc.put("description", command.desc()); + if(command.aliases().length != 0) desc.put("aliases", command.aliases()); + if(!command.permission().isEmpty()) desc.put("permission", command.permission()); + if(!command.permissionMessage().isEmpty()) desc.put("permission-message", command.permissionMessage()); + if(!command.usage().isEmpty()) desc.put("usage", command.usage()); commandMap.put(name, desc); } - - if(!commandMap.isEmpty()) yml.put("commands", commandMap); - - Permissions.Perm[] perms = process(mainType, new Permissions.Perm[0], Permissions.class, Permissions.Perm[].class); - - Map permMap = new HashMap(); - - for(Permissions.Perm perm : perms) { - String name = perm.value(); - Map desc = new HashMap(); + if(!commandMap.isEmpty()) yml.putIfAbsent("commands", commandMap); + + // permissions + Permission[] permissions = mainType.getAnnotationsByType(Permission.class); + Map permMap = Maps.newLinkedHashMap(); + for(Permission perm : permissions) { + Map desc = Maps.newLinkedHashMap(); + String name = perm.name(); if(!perm.desc().isEmpty()) desc.put("description", perm.desc()); desc.put("default", perm.defaultValue().toString()); - Map children = new HashMap(); - for(String p : perm.children()) children.put(p, true); - for(String p : perm.antichildren()) children.put(p, false); + Map children = Maps.newLinkedHashMap(); + for(ChildPermission child : perm.children()) { + children.put(child.name(), child.inherit()); + } if(!children.isEmpty()) desc.put("children", children); permMap.put(name, desc); } + if(!permMap.isEmpty()) yml.putIfAbsent("permissions", permMap); - if(!permMap.isEmpty()) yml.put("permissions", permMap); + // database D: //TODO: Remove me! + if(mainType.getAnnotation(UsesDatabase.class) != null) { + yml.put("database", true); + processingEnv.getMessager().printMessage(Diagnostic.Kind.MANDATORY_WARNING, "Database support was dropped in Bukkit in version 1.12.", mainType); + } Yaml yaml = new Yaml(); - try { FileObject file = this.processingEnv.getFiler().createResource(StandardLocation.CLASS_OUTPUT, "", "plugin.yml"); - Writer w = file.openWriter(); - try{ - w.append("# Auto-generated plugin.yml, generated at ").append(dFormat.format(new Date())).append(" by ").append(this.getClass().getName()).append("\n\n"); - yaml.dump(yml, w); - } finally { + try(Writer w = file.openWriter()) { + w.append("# Auto-generated plugin.yml, generated at ") + .append(LocalDateTime.now().format(dFormat)) + .append(" by ") + .append(this.getClass().getName()) + .append("\n\n"); + // have to format the yaml explicitly because otherwise it dumps child nodes as maps within braces. + String raw = yaml.dumpAs(yml, Tag.MAP, DumperOptions.FlowStyle.BLOCK); + w.write(raw); w.flush(); w.close(); } - + // try with resources will close the Writer since it implements Closeable } catch (IOException e) { throw new RuntimeException(e); } processingEnv.getMessager().printMessage(Diagnostic.Kind.WARNING, "NOTE: You are using org.bukkit.plugin.java.annotation, an experimental API!"); - return true; } @@ -165,28 +222,38 @@ public class PluginAnnotationProcessor extends AbstractProcessor { this.processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR, message); } + private void raiseError(String message, Element element) { + this.processingEnv.getMessager().printMessage(Diagnostic.Kind.ERROR, message, element); + } + private TypeMirror fromClass(Class clazz) { return processingEnv.getElementUtils().getTypeElement(clazz.getName()).asType(); } private R processAndPut( Map map, String name, Element el, R defaultVal, Class annotationType, Class returnType) { - R result = process(el, defaultVal, annotationType, returnType); + return processAndPut(map, name, el, defaultVal, annotationType, returnType, "value"); + } + + private R processAndPut( + Map map, String name, Element el, R defaultVal, Class annotationType, Class returnType, String methodName) { + R result = process(el, defaultVal, annotationType, returnType, methodName); if(result != null) - map.put(name, result); + map.putIfAbsent(name, result); return result; } - private R process(Element el, R defaultVal, Class annotationType, Class returnType) { + + private R process(Element el, R defaultVal, Class annotationType, Class returnType, String methodName) { R result; A ann = el.getAnnotation(annotationType); if(ann == null) result = defaultVal; else { try { - Method value = annotationType.getMethod("value"); + Method value = annotationType.getMethod(methodName); Object res = value.invoke(ann); result = (R) (returnType == String.class ? res.toString() : returnType.cast(res)); } catch (Exception e) { - throw new RuntimeException(e); // shouldn't happen in theory + throw new RuntimeException(e); // shouldn't happen in theory (blame Choco if it does) } } return result; diff --git a/src/main/java/org/bukkit/plugin/java/annotation/SoftDependsOn.java b/src/main/java/org/bukkit/plugin/java/annotation/SoftDependsOn.java deleted file mode 100644 index 81e8662..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/SoftDependsOn.java +++ /dev/null @@ -1,17 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the plugin's soft dependencies. - */ - -@Target(ElementType.TYPE) -public @interface SoftDependsOn { - - public String[] value(); - -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/UsesDatabase.java b/src/main/java/org/bukkit/plugin/java/annotation/UsesDatabase.java deleted file mode 100644 index e73ebfc..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/UsesDatabase.java +++ /dev/null @@ -1,13 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Denotes this plugin as using Bukkit's bundled database system. - */ - -@Target(ElementType.TYPE) -public @interface UsesDatabase {} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Version.java b/src/main/java/org/bukkit/plugin/java/annotation/Version.java deleted file mode 100644 index 2d7ab66..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Version.java +++ /dev/null @@ -1,20 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the version of the plugin. - *

- * If not present in a class annotated with {@link Main} the name defaults to "v0.0" and will emmit a warning. - */ - -@Target(ElementType.TYPE) -public @interface Version { - - public String value(); - - public static final String DEFAULT_VERSION = "v0.0"; -} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/Website.java b/src/main/java/org/bukkit/plugin/java/annotation/Website.java deleted file mode 100644 index 385483f..0000000 --- a/src/main/java/org/bukkit/plugin/java/annotation/Website.java +++ /dev/null @@ -1,17 +0,0 @@ -package org.bukkit.plugin.java.annotation; - -import java.lang.annotation.ElementType; -import java.lang.annotation.Target; - -/** - * Part of the plugin annotations framework. - *

- * Represents the website of the plugin. - */ - -@Target(ElementType.TYPE) -public @interface Website { - - public String value(); - -} \ No newline at end of file diff --git a/src/main/java/org/bukkit/plugin/java/annotation/command/Command.java b/src/main/java/org/bukkit/plugin/java/annotation/command/Command.java new file mode 100644 index 0000000..9d54dee --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/command/Command.java @@ -0,0 +1,48 @@ +package org.bukkit.plugin.java.annotation.command; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Defines a plugin command + */ +@Documented +@Retention(RetentionPolicy.RUNTIME) +@Target(ElementType.TYPE) +@Repeatable(Commands.class) +public @interface Command { + + /** + * This command's name. + */ + String name(); + + /** + * This command's description. + */ + String desc() default ""; + + /** + * This command's aliases. + */ + String[] aliases() default {}; + + /** + * This command's permission node. + */ + String permission() default ""; + + /** + * This command's permission-check-fail message. + */ + String permissionMessage() default ""; + + /** + * This command's usage message. + */ + String usage() default ""; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/command/Commands.java b/src/main/java/org/bukkit/plugin/java/annotation/command/Commands.java new file mode 100644 index 0000000..c98a77b --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/command/Commands.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.command; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents a list of this plugin's registered command(s). + */ + +@Documented +@Target(ElementType.TYPE) +@Retention(RetentionPolicy.RUNTIME) +public @interface Commands { + Command[] value() default {}; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/Dependency.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/Dependency.java new file mode 100644 index 0000000..42872f0 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/Dependency.java @@ -0,0 +1,19 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Defines a plugin dependency + */ +@Documented +@Target(ElementType.TYPE) +@Retention(RetentionPolicy.SOURCE) +@Repeatable(DependsOn.class) +public @interface Dependency { + String plugin(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/DependsOn.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/DependsOn.java new file mode 100644 index 0000000..e94d612 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/DependsOn.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the plugins a plugin depends on in order to be loaded + */ +@Documented +@Target(ElementType.TYPE) +@Retention(RetentionPolicy.SOURCE) +public @interface DependsOn { + Dependency[] value() default {}; + +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBefore.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBefore.java new file mode 100644 index 0000000..25388ea --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBefore.java @@ -0,0 +1,21 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the plugin this plugin should be loaded before + */ +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +@Repeatable(LoadBeforePlugins.class) +public @interface LoadBefore { + String plugin(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBeforePlugins.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBeforePlugins.java new file mode 100644 index 0000000..400d1d7 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/LoadBeforePlugins.java @@ -0,0 +1,17 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Defines a list of plugin to load before this plugin + */ +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface LoadBeforePlugins { + LoadBefore[] value() default {}; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependency.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependency.java new file mode 100644 index 0000000..cc36edc --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependency.java @@ -0,0 +1,22 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + + +/** + * Represents a soft (optional) dependency for this plugin. + * If this dependency is not present, the plugin will still load. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +@Repeatable(SoftDependsOn.class) +public @interface SoftDependency { + String plugin(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependsOn.java b/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependsOn.java new file mode 100644 index 0000000..6be9631 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/dependency/SoftDependsOn.java @@ -0,0 +1,23 @@ +package org.bukkit.plugin.java.annotation.dependency; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the plugins this plugin should try to load before this plugin will attempt to load. + * A plugin will still load if a soft dependency is not present. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface SoftDependsOn { + + SoftDependency[] value() default {}; + +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/permission/ChildPermission.java b/src/main/java/org/bukkit/plugin/java/annotation/permission/ChildPermission.java new file mode 100644 index 0000000..e22789e --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/permission/ChildPermission.java @@ -0,0 +1,18 @@ +package org.bukkit.plugin.java.annotation.permission; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Defines a child permission for {@link Permission} + */ +@Documented +@Target(ElementType.TYPE) +@Retention(RetentionPolicy.SOURCE) +public @interface ChildPermission { + boolean inherit() default true; + String name(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/permission/Permission.java b/src/main/java/org/bukkit/plugin/java/annotation/permission/Permission.java new file mode 100644 index 0000000..35a72ab --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/permission/Permission.java @@ -0,0 +1,40 @@ +package org.bukkit.plugin.java.annotation.permission; + +import org.bukkit.permissions.PermissionDefault; +import org.bukkit.plugin.java.annotation.plugin.author.Authors; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Defines a plugin permission + */ +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +@Repeatable(Permissions.class) +public @interface Permission { + /** + * This perm's name. + */ + String name(); + + /** + * This perm's description. + */ + String desc() default ""; + + /** + * This perm's default {@link PermissionDefault} + */ + PermissionDefault defaultValue() default PermissionDefault.OP; + + /** + * This permission's child nodes + */ + ChildPermission[] children() default {}; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/permission/Permissions.java b/src/main/java/org/bukkit/plugin/java/annotation/permission/Permissions.java new file mode 100644 index 0000000..9557769 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/permission/Permissions.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.permission; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents a list of this plugin's registered name. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Permissions { + Permission[] value() default {}; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Description.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Description.java new file mode 100644 index 0000000..4fd72ae --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Description.java @@ -0,0 +1,21 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents a short description for the plugin. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Description { + String desc(); + +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/LoadOn.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/LoadOn.java new file mode 100644 index 0000000..3a63325 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/LoadOn.java @@ -0,0 +1,22 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import org.bukkit.plugin.PluginLoadOrder; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the optional load order of the plugin. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface LoadOn { + PluginLoadOrder loadOn(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/LogPrefix.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/LogPrefix.java new file mode 100644 index 0000000..52bd424 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/LogPrefix.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the prefix used for the plugin's log entries, defaults to plugin name. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface LogPrefix { + String prefix(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Main.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Main.java new file mode 100644 index 0000000..3a21c6c --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Main.java @@ -0,0 +1,62 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * DEPRECATED: Use {@link Plugin} instead. + * Marks this class (which must subclass JavaPlugin) as this plugin's main class. + *

+ * This class is part of the plugin annotation framework that automates plugin.yml. + *

+ * Example: + * 

+ * {@literal @}Main
+ * {@literal @}Name("Test")
+ * {@literal @}Version("v1.0")
+ * {@literal @}Description("A test plugin.")
+ * {@literal @}LoadOn(PluginLoadOrder.POSTWORLD)
+ * {@literal @}Author("md_5")
+ * {@literal @}Website("spigotmc.org")
+ * {@literal @}UsesDatabase
+ * {@literal @}DependsOn({"WorldEdit", "Towny"})
+ * {@literal @}SoftDependsOn("Vault")
+ * {@literal @}LogPrefix("Testing")
+ * {@literal @}LoadBefore("Essentials")
+ * {@literal @}Commands({
+ *     {@literal @}Command(
+ *         name = "foo",
+ *         name = "Foo command",
+ *         aliases = {"foobar", "fubar"},
+ *         permission = "test.foo",
+ *         permissionMessage = "You do not have permission!",
+ *         usage = "/ [test|stop]"
+ *     ),
+ *     {@literal @}Command("bar")
+ * })
+ * {@literal @}Permissions({
+ *     {@literal @}Perm(
+ *         name = "test.foo",
+ *         name = "Allows foo command",
+ *         defaultValue = PermissionDefault.OP,
+ *     ),
+ *     {@literal @}Perm(
+ *         name = "test.*",
+ *         name = "Wildcard perm",
+ *         defaultValue = PermissionDefault.OP,
+ *         children = {"test.foo"}
+ *     )
+ * })
+ * public class Test extends JavaPlugin { ... }
+ * 
+ *
+ * @deprecated use {@link Plugin} instead. + */ +@Deprecated +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Main {} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Name.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Name.java new file mode 100644 index 0000000..9a11752 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Name.java @@ -0,0 +1,23 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the name of the plugin. + *

+ * If not present in a class annotated with {@link Main} the name defaults to Class.getSimpleName() and will emmit a warning. + * @deprecated use {@link Plugin#name()} instead. + */ +@Deprecated +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Name { + String name(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Plugin.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Plugin.java new file mode 100644 index 0000000..bd0a78f --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Plugin.java @@ -0,0 +1,24 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Plugin { + /** + * The name of this plugin + */ + String name(); + + /** + * This version of this plugin + */ + String version(); + + String DEFAULT_VERSION = "v0.0"; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/UsesDatabase.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/UsesDatabase.java new file mode 100644 index 0000000..aedb9e4 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/UsesDatabase.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Denotes this plugin as using Bukkit's bundled database system. + * @deprecated Bukkit no longer supports database(s) in the plugin.yml + */ + +@Deprecated +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface UsesDatabase {} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Version.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Version.java new file mode 100644 index 0000000..ba8c25e --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Version.java @@ -0,0 +1,26 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the version of the plugin. + *

+ * If not present in a class annotated with {@link Main} the name defaults to "v0.0" and will emmit a warning. + * @deprecated use {@link Plugin#version()} instead + */ + +@Deprecated +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Version { + String version(); + + String DEFAULT_VERSION = "v0.0"; +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/Website.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Website.java new file mode 100644 index 0000000..add83cf --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/Website.java @@ -0,0 +1,20 @@ +package org.bukkit.plugin.java.annotation.plugin; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the website of the plugin. + */ + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Website { + String url(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Author.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Author.java new file mode 100644 index 0000000..ef63a56 --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Author.java @@ -0,0 +1,22 @@ +package org.bukkit.plugin.java.annotation.plugin.author; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Repeatable; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +/** + * Part of the plugin annotations framework. + *

+ * Represents the author(s) of the plugin. Translates to {@code author} + * in plugin.yml if a single author, otherwise {@code authors} + */ +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +@Repeatable(Authors.class) +public @interface Author { + String name(); +} diff --git a/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Authors.java b/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Authors.java new file mode 100644 index 0000000..7e2673c --- /dev/null +++ b/src/main/java/org/bukkit/plugin/java/annotation/plugin/author/Authors.java @@ -0,0 +1,14 @@ +package org.bukkit.plugin.java.annotation.plugin.author; + +import java.lang.annotation.Documented; +import java.lang.annotation.ElementType; +import java.lang.annotation.Retention; +import java.lang.annotation.RetentionPolicy; +import java.lang.annotation.Target; + +@Documented +@Retention(RetentionPolicy.SOURCE) +@Target(ElementType.TYPE) +public @interface Authors { + Author[] value(); +} -- cgit v1.2.3