如何在自己的API中发出警告信息？

Question

是否可以在我自己的API中提供自定义警告消息,如下所示？Resource leak:'ois' is never closed消息是否与Java API或JVM相关？

Answer 1

可以使用编译器API.您必须扩展AbstractProcessor,然后确保编译器知道它.

让我们说我们不喜欢程序员在源代码中发誓.因此,当有人定义名为"shit"的字段时,我们希望显示警告.这是一个简单的实现:

import java.util.List;
import java.util.Set;

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.ElementKind;
import javax.lang.model.element.TypeElement;
import javax.tools.Diagnostic.Kind;

@SupportedSourceVersion(SourceVersion.RELEASE_7)
@SupportedAnnotationTypes("*")
public class Test extends AbstractProcessor {
    public int shit;
    public int foo;

    @Override
    public boolean process(Set<? extends TypeElement> annotations, RoundEnvironment roundEnv) {
        Set<? extends Element> rootElements = roundEnv.getRootElements();

        for (Element element : rootElements) {
            if (element.getKind() == ElementKind.CLASS) {
                List<? extends Element> classElements = element.getEnclosedElements();

                for (Element classElement : classElements) {
                    if (classElement.getKind() == ElementKind.FIELD) {
                        if (classElement.getSimpleName().contentEquals("shit")) {
                            processingEnv.getMessager().printMessage(
                                Kind.WARNING,
                                "How dare you to swear in the source code?!",
                                classElement
                            );
                        }
                    }
                }
            }
        }

        return false;
    }

    public static void main(String[] args) {
        //
    }
}

现在,我们想要为这个类应用这样的处理器,因为还有一个丑陋的坏叫字段.

使用命令行:

javac Test.java
javac -processor Test Test.java

我们需要首先构建一个处理器,然后在编译时应用它(在这种情况下是同一个文件).

这是我们获得的输出:

Test.java:17: warning: How dare you to swear in the source code?!
    public int shit;
           ^
1 warning

要在Eclipse或任何其他IDE中发出相同的警告,必须更改编译器设置,以便它使用此自定义处理器.

更新:在评论中,kapep发送了一个关于如何在Eclipse中设置自定义处理器的链接:http://kerebus.com/2011/02/using-java-6-processors-in-eclipse/

仅供记录:通过实现接口Closeable可以实现完全相同的警告:

import java.io.Closeable;
import java.io.IOException;

public class Test implements Closeable {
    @Override
    public void close() throws IOException {
        // TODO Auto-generated method stub
    }

    public static void main(String[] args) {
        new Test();
    }
}

你看到同样的警告: