release_3.6 to master

.circleci/config.yml

@@ -14,12 +14,13 @@ jobs:
     - checkout
     - run:
         name: multi_os_result
-        command: curl http://60.205.215.34/multi_os_result
+        command: echo "curl http://60.205.215.34/multi_os_result"
+#
+#    - run:
+#        name: Daily Build Report
+#        command: curl http://60.205.215.34/Daily_Build_Task_Report
+#
+#    - run:
+#        name: Download Links
+#        command: sh DownloadLinks.sh
 
-    - run:
-        name: Daily Build Report
-        command: curl http://60.205.215.34/Daily_Build_Task_Report
-
-    - run:
-        name: Download Links
-        command: sh DownloadLinks.sh

build.gradle

@@ -180,6 +180,8 @@ dependencies {
 
     compile "io.vavr:vavr:0.9.2"
     compile group: 'org.pf4j', name: 'pf4j', version: '2.5.0'
+    compile group: 'org.zeromq', name: 'jeromq', version: '0.5.0'
+
 }
 
 check.dependsOn 'lint'

build.md

@@ -0,0 +1,84 @@
+# How to Build
+
+## Prepare dependencies
+
+* JDK 1.8 (JDK 1.9+ are not supported yet)
+* On Linux Ubuntu system (e.g. Ubuntu 16.04.4 LTS), ensure that the machine has [__Oracle JDK 8__](https://www.digitalocean.com/community/tutorials/how-to-install-java-with-apt-get-on-ubuntu-16-04), instead of having __Open JDK 8__ in the system. If you are building the source code by using __Open JDK 8__, you will get [__Build Failed__](https://github.com/tronprotocol/java-tron/issues/337) result.
+* Open **UDP** ports for connection to the network
+* **MINIMUM** 2 ENERGY Cores
+
+## Build and Deploy automatically using scripts
+
+- Please take a look at the [Tron Deployment Scripts](https://github.com/tronprotocol/TronDeployment) repository.
+
+## Getting the code with git
+
+* Use Git from the Terminal, see the [Setting up Git](https://help.github.com/articles/set-up-git/) and [Fork a Repo](https://help.github.com/articles/fork-a-repo/) articles.
+* develop branch: the newest code 
+* master branch: more stable than develop.
+In the shell command, type:
+```bash
+git clone https://github.com/tronprotocol/java-tron.git
+git checkout -t origin/master
+```
+
+* For Mac, you can also install **[GitHub for Mac](https://mac.github.com/)** then **[fork and clone our repository](https://guides.github.com/activities/forking/)**. 
+
+* If you'd rather not use Git, [Download the ZIP](https://github.com/tronprotocol/java-tron/archive/develop.zip)
+
+## Including java-tron as dependency
+
+* If you don't want to checkout the code and build the project, you can include it directly as a dependency
+
+**Using gradle:**
+
+```
+repositories {
+   maven { url 'https://jitpack.io' }
+}
+dependencies {
+   implementation 'com.github.tronprotocol:java-tron:develop-SNAPSHOT'
+}
+```
+
+**Using maven:**
+
+```xml
+...
+<repositories>
+  <repository>    
+      <id>jitpack.io</id>
+      <url>https://jitpack.io</url>
+  </repository>
+</repositories>
+...
+<dependency>
+    <groupId>com.github.tronprotocol</groupId>
+    <artifactId>java-tron</artifactId>
+    <version>develop-SNAPSHOT</version><!--You can use any of the tag/branch name available-->
+</dependency>
+```
+
+
+
+
+## Building from source code
+
+* Build in the Terminal
+
+```bash
+cd java-tron
+./gradlew build
+```
+
+
+* Build in [IntelliJ IDEA](https://www.jetbrains.com/idea/) (community version is enough):
+
+  **Please run ./gradlew build once to build the protocol files**
+
+  1. Start IntelliJ. Select `File` -> `Open`, then locate to the java-tron folder which you have git cloned to your local drive. Then click `Open` button on the right bottom.
+  2. Check on `Use auto-import` on the `Import Project from Gradle` dialog. Select JDK 1.8 in the `Gradle JVM` option. Then click `OK`.
+  3. IntelliJ will open the project and start gradle syncing, which will take several minutes, depending on your network connection and your IntelliJ configuration
+  4. Enable Annotations, `Preferences` -> Search `annotations` -> check `Enable Annotation Processing`.
+  5. After the syncing finished, select `Gradle` -> `Tasks` -> `build`, and then double click `build` option.
+

config/checkstyle/checkStyleAll.xml

@@ -19,7 +19,7 @@
     <property name="charset" value="UTF-8"/>
 
     <property name="severity" value="warning"/>
-
+    <!--<property name="localeLanguage" value="en"/>-->
     <property name="fileExtensions" value="java, properties, xml"/>
     <!-- Checks for whitespace                               -->
     <!-- See http://checkstyle.sf.net/config_whitespace.html -->
@@ -108,51 +108,51 @@
             <property name="tokens" value="METHOD_REF"/>
             <property name="option" value="nl"/>
         </module>
-        <module name="PackageName">
-            <property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/>
-            <message key="name.invalidPattern"
-                     value="Package name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="TypeName">
-            <message key="name.invalidPattern"
-                     value="Type name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="MemberName">
-            <property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9]*$"/>
-            <message key="name.invalidPattern"
-                     value="Member name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="ParameterName">
-            <property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>
-            <message key="name.invalidPattern"
-                     value="Parameter name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="CatchParameterName">
-            <property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>
-            <message key="name.invalidPattern"
-                     value="Catch parameter name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="LocalVariableName">
-            <property name="tokens" value="VARIABLE_DEF"/>
-            <property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>
-            <message key="name.invalidPattern"
-                     value="Local variable name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="ClassTypeParameterName">
-            <property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>
-            <message key="name.invalidPattern"
-                     value="Class type name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="MethodTypeParameterName">
-            <property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>
-            <message key="name.invalidPattern"
-                     value="Method type name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="InterfaceTypeParameterName">
-            <property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>
-            <message key="name.invalidPattern"
-                     value="Interface type name ''{0}'' must match pattern ''{1}''."/>
-        </module>
+        <!--<module name="PackageName">-->
+            <!--<property name="format" value="^[a-z]+(\.[a-z][a-z0-9]*)*$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Package name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="TypeName">-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Type name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="MemberName">-->
+            <!--<property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9]*$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Member name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="ParameterName">-->
+            <!--<property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Parameter name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="CatchParameterName">-->
+            <!--<property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Catch parameter name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="LocalVariableName">-->
+            <!--<property name="tokens" value="VARIABLE_DEF"/>-->
+            <!--<property name="format" value="^[a-z]([a-z0-9][a-zA-Z0-9]*)?$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Local variable name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="ClassTypeParameterName">-->
+            <!--<property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Class type name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="MethodTypeParameterName">-->
+            <!--<property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Method type name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="InterfaceTypeParameterName">-->
+            <!--<property name="format" value="(^[A-Z][0-9]?)$|([A-Z][a-zA-Z0-9]*[T]$)"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Interface type name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
         <module name="NoFinalizer"/>
         <module name="GenericWhitespace">
             <message key="ws.followed"
@@ -172,12 +172,12 @@
             <property name="lineWrappingIndentation" value="4"/>
             <property name="arrayInitIndent" value="2"/>
         </module>
-        <module name="AbbreviationAsWordInName">
-            <property name="ignoreFinal" value="false"/>
-            <property name="allowedAbbreviationLength" value="1"/>
-        </module>
+        <!--<module name="AbbreviationAsWordInName">-->
+            <!--<property name="ignoreFinal" value="false"/>-->
+            <!--<property name="allowedAbbreviationLength" value="1"/>-->
+        <!--</module>-->
         <module name="OverloadMethodsDeclarationOrder"/>
-        <module name="VariableDeclarationUsageDistance"/>
+        <!--<module name="VariableDeclarationUsageDistance"/>-->
         <module name="CustomImportOrder">
             <property name="sortImportsInGroupAlphabetically" value="true"/>
             <property name="separateLineBetweenGroups" value="true"/>
@@ -203,32 +203,32 @@
             <property name="allowSamelineMultipleAnnotations" value="true"/>
         </module>
         <module name="NonEmptyAtclauseDescription"/>
-        <module name="JavadocTagContinuationIndentation"/>
-        <module name="SummaryJavadoc">
-            <property name="forbiddenSummaryFragments" value="^@return the *|^This method returns |^A [{]@code [a-zA-Z0-9]+[}]( is a )"/>
-        </module>
-        <module name="JavadocParagraph"/>
-        <module name="AtclauseOrder">
-            <property name="tagOrder" value="@param, @return, @throws, @deprecated"/>
-            <property name="target" value="CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, CTOR_DEF, VARIABLE_DEF"/>
-        </module>
-        <module name="JavadocMethod">
-            <property name="scope" value="public"/>
-            <property name="allowMissingParamTags" value="true"/>
-            <property name="allowMissingThrowsTags" value="true"/>
-            <property name="allowMissingReturnTag" value="true"/>
-            <property name="minLineCount" value="2"/>
-            <property name="allowedAnnotations" value="Override, Test"/>
-            <property name="allowThrowsTagsForSubclasses" value="true"/>
-        </module>
-        <module name="MethodName">
-            <property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9_]*$"/>
-            <message key="name.invalidPattern"
-                     value="Method name ''{0}'' must match pattern ''{1}''."/>
-        </module>
-        <module name="SingleLineJavadoc">
-            <property name="ignoreInlineTags" value="false"/>
-        </module>
+        <!--<module name="JavadocTagContinuationIndentation"/>-->
+        <!--<module name="SummaryJavadoc">-->
+            <!--<property name="forbiddenSummaryFragments" value="^@return the *|^This method returns |^A [{]@code [a-zA-Z0-9]+[}]( is a )"/>-->
+        <!--</module>-->
+        <!--<module name="JavadocParagraph"/>-->
+        <!--<module name="AtclauseOrder">-->
+            <!--<property name="tagOrder" value="@param, @return, @throws, @deprecated"/>-->
+            <!--<property name="target" value="CLASS_DEF, INTERFACE_DEF, ENUM_DEF, METHOD_DEF, CTOR_DEF, VARIABLE_DEF"/>-->
+        <!--</module>-->
+        <!--<module name="JavadocMethod">-->
+            <!--<property name="scope" value="public"/>-->
+            <!--<property name="allowMissingParamTags" value="true"/>-->
+            <!--<property name="allowMissingThrowsTags" value="true"/>-->
+            <!--<property name="allowMissingReturnTag" value="true"/>-->
+            <!--<property name="minLineCount" value="2"/>-->
+            <!--<property name="allowedAnnotations" value="Override, Test"/>-->
+            <!--<property name="allowThrowsTagsForSubclasses" value="true"/>-->
+        <!--</module>-->
+        <!--<module name="MethodName">-->
+            <!--<property name="format" value="^[a-z][a-z0-9][a-zA-Z0-9_]*$"/>-->
+            <!--<message key="name.invalidPattern"-->
+                     <!--value="Method name ''{0}'' must match pattern ''{1}''."/>-->
+        <!--</module>-->
+        <!--<module name="SingleLineJavadoc">-->
+            <!--<property name="ignoreInlineTags" value="false"/>-->
+        <!--</module>-->
         <module name="EmptyCatchBlock">
             <property name="exceptionVariableName" value="expected"/>
         </module>

querySonar.sh

@@ -0,0 +1,10 @@
+
+PassFlag=`curl -s 'https://sonarcloud.io/api/project_badges/measure?project=java-tron&metric=alert_status'|grep -A4 "quality gate"|grep "pass"|wc -l`
+echo "Please visit https://sonarcloud.io/dashboard?id=java-tron for more details"
+if [ $PassFlag -eq 0 ]; then
+    echo "Sonar Check Failed"
+    exit 1
+else
+    echo "Sonar Check Pass"
+    exit 0
+fi