天天看点

正确的php一句话木马_如果你做正确的话

正确的php一句话木马

这是哲学上或道德上的命令。 很一般。 这就像“快速失败”。 我想到它的原因是我想使用Java 8编译和发布License3j,而JavaDoc在发行版本构建期间拒绝编译。

该软件包是一个简单的许可证管理器,它具有一定的用户基础,要求我跟上BouncyCastle的新版本。 它本身是一个加密软件包,不应过时,并且鼓励程序使用最新版本,以避免安全问题。 当我执行

mvn release:prepare

,出现很多错误:

[ERROR] * <p>
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/License3j.java:132: error: unexpected end tag: </p>
[ERROR] * </p>
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/License3j.java:134: warning: no @param for args
[ERROR] public static void main(String[] args) throws Exception {
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/License3j.java:134: warning: no @throws for java.lang.Exception
[ERROR] public static void main(String[] args) throws Exception {
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/com/verhas/licensor/ExtendedLicense.java:73: warning: no @param for expiryDate
[ERROR] public void setExpiry(final Date expiryDate) {
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/com/verhas/licensor/License.java:196: warning: no description for @throws
[ERROR] * @throws IOException
[ERROR] ^
[ERROR] /Users/verhasp/github/License3j/src/main/java/com/verhas/licensor/License.java:246: warning: no description for @throws
           

新的JavaDoc希望您DIR

出现错误是因为License3j的Java文档有点草率。 抱歉,我是很多年前创建的代码,老实说,不仅可以改进Java文档。 事实上,其中一个单元测试依赖于网络和GitHub的可达性。 (不过,我已经解决了。)

对于JavaDoc,新的Java版本8非常严格。 如您所见,在ORACLE的“ Javadoc的增强功能Java SE 8 ”页面上:

Javadoc工具现在支持检查javadoc注释的内容中是否存在由javadoc生成的文件中可能导致各种问题的问题,例如无效HTML或可访问性问题。 该功能默认情况下处于启用状态,也可以通过新的-Xdoclint选项进行控制。 有关更多详细信息,请参见运行“ javadoc -X”的输出。 该功能在javac中也可用,尽管默认情况下未启用它。

为了使发行版正常工作,我可以选择修复JavaDoc或使用配置

<plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.9</version>
    <executions>
        <execution>
            <id>attach-javadocs</id>
            <goals>
                <goal>jar</goal>
            </goals>
            <configuration>
                <additionalparam>-Xdoclint:none</additionalparam>
            </configuration>
        </execution>
    </executions>
</plugin>
           

pom.xml

。 (来源为stackoverflow 。)

但是你不会DIR

您可以容易地想象,当您承受时间压力时,您将选择第二个选项。 您解决了修改

pom.xml

或其他构建配置的问题,而

pom.xml

任何操作。

但是,您继续思考为什么会这样吗? 为什么默认情况下新工具严格? 这是一个好选择吗? 它会促使人们创建更好的JavaDoc吗?

(现在,我只是认为新行为的目的是促使程序员创建更好的JavaDoc文档,而不仅仅是使我们烦恼。)

我有点怀疑,仅此一项就足以改进文档。 程序员将:

  • 关闭棉绒选项。
  • 从源中删除JavaDoc。
  • 写一些Java 8可以接受的描述,但通常是没有意义的。

否则其中一些只会编写正确的Java文档。 无论如何,其中有些人写得很好,新的严格性会有所帮助。 我们有几个? 1%还是2%? 其他人只会将其视为鞭子并尝试避免。 我们需要胡萝卜。 嘿,兔子! 胡萝卜在哪里?

翻译自: https://www.javacodegeeks.com/2015/06/if-you-do-it-do-it-right.html

正确的php一句话木马