天天看點

正确的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一句話木馬