This is an automated email from the ASF dual-hosted git repository.
jleroux pushed a commit to branch trunk
in repository https://gitbox.apache.org/repos/asf/ofbiz-framework.git
The following commit(s) were added to refs/heads/trunk by this push:
new c85f602 Improved: Remove Checkstyle warning related to double
parenthesis at start of lines (OFBIZ-12340)
c85f602 is described below
commit c85f60279ba5ef42224faad0065d6435326de643
Author: Jacques Le Roux <[email protected]>
AuthorDate: Sun Oct 17 15:34:15 2021 +0200
Improved: Remove Checkstyle warning related to double parenthesis at start
of lines (OFBIZ-12340)
At https://markmail.org/message/3mhzlqew3igad3r2 I reported an issue that I
was
not able to really qualify. After exchanging with a Checkstyle expert
(see markmail thread).
I was unable to find what in our checkstyle.xml file was wrongly throwing
these
warnings. I decided that there was no reason to throw those warnings.
So I decided to put the SuppressionCommentFilter in our checkstyle.xml file
and
use CHECKSTYLE_OFF: ALMOST_ALL/CHECKSTYLE_ON: ALMOST_ALL around
the concerned lines as documented here
https://checkstyle.sourceforge.io/config_filters.html#SuppressionCommentFilter_Examples
---
.../ofbiz/party/communication/CommunicationEventServices.java | 2 ++
config/checkstyle/checkstyle.xml | 5 +++++
.../org/apache/ofbiz/base/conversion/NumberConverters.java | 2 ++
.../src/main/java/org/apache/ofbiz/base/util/HttpClient.java | 2 ++
.../main/java/org/apache/ofbiz/base/util/ReferenceCleaner.java | 2 ++
.../base/src/main/java/org/apache/ofbiz/base/util/SSLUtil.java | 2 ++
.../src/main/java/org/apache/ofbiz/base/util/URLConnector.java | 2 ++
.../main/java/org/apache/ofbiz/base/util/cache/UtilCache.java | 2 ++
.../org/apache/ofbiz/catalina/container/CatalinaContainer.java | 4 ++++
.../java/org/apache/ofbiz/entity/condition/EntityExpr.java | 2 ++
.../java/org/apache/ofbiz/service/mail/MimeMessageWrapper.java | 4 ++++
.../java/org/apache/ofbiz/service/rmi/RmiServiceContainer.java | 2 ++
.../ofbiz/service/xmlrpc/AliasSupportedTransportFactory.java | 2 ++
.../main/java/org/apache/ofbiz/testtools/ModelTestSuite.java | 2 ++
.../java/org/apache/ofbiz/widget/renderer/FormRenderer.java | 10 ++++++++--
.../main/java/org/apache/ofbiz/widget/renderer/Paginator.java | 2 ++
.../org/apache/ofbiz/widget/renderer/html/HtmlMenuWrapper.java | 4 ++++
17 files changed, 49 insertions(+), 2 deletions(-)
diff --git
a/applications/party/src/main/java/org/apache/ofbiz/party/communication/CommunicationEventServices.java
b/applications/party/src/main/java/org/apache/ofbiz/party/communication/CommunicationEventServices.java
index 35b999a..784fd57 100644
---
a/applications/party/src/main/java/org/apache/ofbiz/party/communication/CommunicationEventServices.java
+++
b/applications/party/src/main/java/org/apache/ofbiz/party/communication/CommunicationEventServices.java
@@ -467,7 +467,9 @@ public class CommunicationEventServices {
try (EntityListIterator eli = eq.queryIterator()) {
// Send an email to each contact list member
// loop through the list iterator
+ // CHECKSTYLE_OFF: ALMOST_ALL
for (GenericValue contactListPartyAndContactMech;
(contactListPartyAndContactMech = eli.next()) != null;) {
+ // CHECKSTYLE_N: ALMOST_ALL
Debug.logInfo("Contact info: " +
contactListPartyAndContactMech, MODULE);
// Any exceptions thrown in this inner block will only
relate to a single email of the list, so should
// only be logged and not cause the service to return an
error
diff --git a/config/checkstyle/checkstyle.xml b/config/checkstyle/checkstyle.xml
index 08e3580..0c68c12 100644
--- a/config/checkstyle/checkstyle.xml
+++ b/config/checkstyle/checkstyle.xml
@@ -49,6 +49,11 @@ under the License.
<module name="TreeWalker">
<!-- Naming conventions -->
+ <module name="SuppressionCommentFilter">
+ <!-- see OFBIZ-12340 for details -->
+ <property name="offCommentFormat" value="CHECKSTYLE_OFF:
ALMOST_ALL"/>
+ <property name="onCommentFormat" value="CHECKSTYLE_ON:
ALMOST_ALL"/>
+ </module>
<module name="ConstantName"/>
<module name="LocalFinalVariableName"/>
<module name="LocalVariableName"/>
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/conversion/NumberConverters.java
b/framework/base/src/main/java/org/apache/ofbiz/base/conversion/NumberConverters.java
index 994169a..fce8f9c 100644
---
a/framework/base/src/main/java/org/apache/ofbiz/base/conversion/NumberConverters.java
+++
b/framework/base/src/main/java/org/apache/ofbiz/base/conversion/NumberConverters.java
@@ -34,7 +34,9 @@ public class NumberConverters implements ConverterLoader {
protected static Number fromString(String str, Locale locale) throws
ConversionException {
NumberFormat nf = NumberFormat.getNumberInstance(locale);
if (nf instanceof DecimalFormat) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((DecimalFormat) nf).setParseBigDecimal(true);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
try {
return nf.parse(str);
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/util/HttpClient.java
b/framework/base/src/main/java/org/apache/ofbiz/base/util/HttpClient.java
index b6fc841..1fac152 100644
--- a/framework/base/src/main/java/org/apache/ofbiz/base/util/HttpClient.java
+++ b/framework/base/src/main/java/org/apache/ofbiz/base/util/HttpClient.java
@@ -477,7 +477,9 @@ public class HttpClient {
}
if ((con instanceof HttpURLConnection)) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((HttpURLConnection)
con).setInstanceFollowRedirects(followRedirects);
+ // CHECKSTYLE_ON: ALMOST_ALL
if (Debug.verboseOn() || debug) {
Debug.logVerbose("Connection is of type HttpURLConnection,
more specifically: " + con.getClass().getName(), MODULE);
}
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/util/ReferenceCleaner.java
b/framework/base/src/main/java/org/apache/ofbiz/base/util/ReferenceCleaner.java
index 0aecd03..e0b2f73 100644
---
a/framework/base/src/main/java/org/apache/ofbiz/base/util/ReferenceCleaner.java
+++
b/framework/base/src/main/java/org/apache/ofbiz/base/util/ReferenceCleaner.java
@@ -42,7 +42,9 @@ public final class ReferenceCleaner {
public void run() {
while (keepRunning) {
try {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((Removable) QUEUE.remove()).remove();
+ // CHECKSTYLE_ON: ALMOST_ALL
} catch (Throwable t) {
// ignore
}
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/util/SSLUtil.java
b/framework/base/src/main/java/org/apache/ofbiz/base/util/SSLUtil.java
index 5d8f941..c584bea 100644
--- a/framework/base/src/main/java/org/apache/ofbiz/base/util/SSLUtil.java
+++ b/framework/base/src/main/java/org/apache/ofbiz/base/util/SSLUtil.java
@@ -115,7 +115,9 @@ public final class SSLUtil {
for (TrustManager mgr : mgrs) {
if (mgr instanceof X509TrustManager) {
try {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((X509TrustManager) mgr).checkClientTrusted(chain,
authType);
+ // CHECKSTYLE_ON: ALMOST_ALL
return true;
} catch (CertificateException e) {
Debug.logError(e, MODULE);
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/util/URLConnector.java
b/framework/base/src/main/java/org/apache/ofbiz/base/util/URLConnector.java
index 9b41456..803adf1 100644
--- a/framework/base/src/main/java/org/apache/ofbiz/base/util/URLConnector.java
+++ b/framework/base/src/main/java/org/apache/ofbiz/base/util/URLConnector.java
@@ -154,7 +154,9 @@ public class URLConnector {
// closes the HttpURLConnection does nothing to others
private static void close(URLConnection con) {
if (con instanceof HttpURLConnection) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((HttpURLConnection) con).disconnect();
+ // CHECKSTYLE_ON: ALMOST_ALL
}
}
}
diff --git
a/framework/base/src/main/java/org/apache/ofbiz/base/util/cache/UtilCache.java
b/framework/base/src/main/java/org/apache/ofbiz/base/util/cache/UtilCache.java
index 00aa96d..dace450 100644
---
a/framework/base/src/main/java/org/apache/ofbiz/base/util/cache/UtilCache.java
+++
b/framework/base/src/main/java/org/apache/ofbiz/base/util/cache/UtilCache.java
@@ -544,7 +544,9 @@ public final class UtilCache<K, V> implements Serializable,
EvictionListener<Obj
if (newInMemory > 0) {
if (this.memoryTable instanceof ConcurrentLinkedHashMap<?, ?>) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((ConcurrentLinkedHashMap<?, ?>)
this.memoryTable).setCapacity(newInMemory);
+ // CHECKSTYLE_ON: ALMOST_ALL
return;
}
this.memoryTable = new Builder<Object, CacheLine<V>>()
diff --git
a/framework/catalina/src/main/java/org/apache/ofbiz/catalina/container/CatalinaContainer.java
b/framework/catalina/src/main/java/org/apache/ofbiz/catalina/container/CatalinaContainer.java
index ed50d7c..06e4929 100644
---
a/framework/catalina/src/main/java/org/apache/ofbiz/catalina/container/CatalinaContainer.java
+++
b/framework/catalina/src/main/java/org/apache/ofbiz/catalina/container/CatalinaContainer.java
@@ -115,7 +115,9 @@ public class CatalinaContainer implements Container {
ofBizRealm.setCredentialHandler(new SimpleCredentialHandler());
}
host.setRealm(ofBizRealm);
+ // CHECKSTYLE_OFF: ALMOST_ALL
((StandardHost) host).addValve(new SingleSignOn());
+ // CHECKSTYLE_ON: ALMOST_ALL
}
// clustering, valves and connectors setup
@@ -227,8 +229,10 @@ public class CatalinaContainer implements Container {
host.setDeployOnStartup(false);
host.setBackgroundProcessorDelay(5);
host.setAutoDeploy(false);
+ // CHECKSTYLE_OFF: ALMOST_ALL
((StandardHost) host).setWorkDir(new
File(System.getProperty(Globals.CATALINA_HOME_PROP),
"work" + File.separator + host.getName()).getAbsolutePath());
+ // CHECKSTYLE_ON: ALMOST_ALL
return host;
}
diff --git
a/framework/entity/src/main/java/org/apache/ofbiz/entity/condition/EntityExpr.java
b/framework/entity/src/main/java/org/apache/ofbiz/entity/condition/EntityExpr.java
index 8cfc8a0..9e87c5b 100644
---
a/framework/entity/src/main/java/org/apache/ofbiz/entity/condition/EntityExpr.java
+++
b/framework/entity/src/main/java/org/apache/ofbiz/entity/condition/EntityExpr.java
@@ -150,8 +150,10 @@ public final class EntityExpr implements EntityCondition {
@Override
public void checkCondition(ModelEntity modelEntity) throws
GenericModelException {
if (lhs instanceof EntityCondition) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((EntityCondition) lhs).checkCondition(modelEntity);
((EntityCondition) rhs).checkCondition(modelEntity);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
}
diff --git
a/framework/service/src/main/java/org/apache/ofbiz/service/mail/MimeMessageWrapper.java
b/framework/service/src/main/java/org/apache/ofbiz/service/mail/MimeMessageWrapper.java
index 5459603..6d47d4d 100644
---
a/framework/service/src/main/java/org/apache/ofbiz/service/mail/MimeMessageWrapper.java
+++
b/framework/service/src/main/java/org/apache/ofbiz/service/mail/MimeMessageWrapper.java
@@ -633,7 +633,9 @@ public class MimeMessageWrapper implements
java.io.Serializable {
StringBuilder builder = new StringBuilder();
byte[] buffer = new byte[4096];
try {
+ // CHECKSTYLE_OFF: ALMOST_ALL
for (int n; (n = stream.read(buffer)) != -1;) {
+ // CHECKSTYLE_ON: ALMOST_ALL
builder.append(new String(buffer, 0, n, "UTF-8"));
}
} catch (IOException e) {
@@ -651,7 +653,9 @@ public class MimeMessageWrapper implements
java.io.Serializable {
protected ByteBuffer getByteBufferFromStream(InputStream stream) {
byte[] buffer = new byte[4096];
try (ByteArrayOutputStream baos = new ByteArrayOutputStream()) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
for (int n; (n = stream.read(buffer)) != -1;) {
+ // CHECKSTYLE_ON: ALMOST_ALL
baos.write(buffer, 0, n);
}
return ByteBuffer.wrap(baos.toByteArray());
diff --git
a/framework/service/src/main/java/org/apache/ofbiz/service/rmi/RmiServiceContainer.java
b/framework/service/src/main/java/org/apache/ofbiz/service/rmi/RmiServiceContainer.java
index 49d6f05..729342d 100644
---
a/framework/service/src/main/java/org/apache/ofbiz/service/rmi/RmiServiceContainer.java
+++
b/framework/service/src/main/java/org/apache/ofbiz/service/rmi/RmiServiceContainer.java
@@ -123,11 +123,13 @@ public class RmiServiceContainer implements Container {
// set the client auth flag on our custom SSL socket factory
if (ssf != null && ssf instanceof
org.apache.ofbiz.service.rmi.socket.ssl.SSLServerSocketFactory) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((org.apache.ofbiz.service.rmi.socket.ssl.SSLServerSocketFactory)
ssf).setNeedClientAuth(clientAuth);
((org.apache.ofbiz.service.rmi.socket.ssl.SSLServerSocketFactory)
ssf).setKeyStoreAlias(ksAlias);
if (keystore != null) {
((org.apache.ofbiz.service.rmi.socket.ssl.SSLServerSocketFactory)
ssf).setKeyStore(keystore, ksType, ksPass);
}
+ // CHECKSTYLE_ON: ALMOST_ALL
}
// get the delegator for this container
diff --git
a/framework/service/src/main/java/org/apache/ofbiz/service/xmlrpc/AliasSupportedTransportFactory.java
b/framework/service/src/main/java/org/apache/ofbiz/service/xmlrpc/AliasSupportedTransportFactory.java
index 614b220..ad964c9 100644
---
a/framework/service/src/main/java/org/apache/ofbiz/service/xmlrpc/AliasSupportedTransportFactory.java
+++
b/framework/service/src/main/java/org/apache/ofbiz/service/xmlrpc/AliasSupportedTransportFactory.java
@@ -115,7 +115,9 @@ public class AliasSupportedTransportFactory extends
XmlRpcTransportFactoryImpl {
@Override
protected void close() throws XmlRpcClientException {
if (con instanceof HttpURLConnection) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((HttpURLConnection) con).disconnect();
+ // CHECKSTYLE_ON: ALMOST_ALL
}
}
diff --git
a/framework/testtools/src/main/java/org/apache/ofbiz/testtools/ModelTestSuite.java
b/framework/testtools/src/main/java/org/apache/ofbiz/testtools/ModelTestSuite.java
index f5639a5..547f9cc 100644
---
a/framework/testtools/src/main/java/org/apache/ofbiz/testtools/ModelTestSuite.java
+++
b/framework/testtools/src/main/java/org/apache/ofbiz/testtools/ModelTestSuite.java
@@ -199,10 +199,12 @@ public class ModelTestSuite {
prepareTest(subTests.nextElement());
}
} else if (test instanceof EntityTestCase) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((EntityTestCase) test).setDelegator(delegator);
if (test instanceof OFBizTestCase) {
((OFBizTestCase) test).setDispatcher(dispatcher);
}
+ // CHECKSTYLE_ON: ALMOST_ALL
} else if (test instanceof GroovyScriptTestCase) {
prepareGroovyScriptTestCase((GroovyScriptTestCase) test);
}
diff --git
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/FormRenderer.java
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/FormRenderer.java
index 6c61a39..937ca85 100644
---
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/FormRenderer.java
+++
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/FormRenderer.java
@@ -38,6 +38,8 @@ import java.util.function.Predicate;
import java.util.stream.Collector;
import java.util.stream.Collectors;
+import javax.servlet.http.HttpServletRequest;
+
import org.apache.ofbiz.base.util.Debug;
import org.apache.ofbiz.base.util.UtilGenerics;
import org.apache.ofbiz.base.util.UtilMisc;
@@ -58,8 +60,6 @@ import org.apache.ofbiz.widget.model.ModelGrid;
import org.apache.ofbiz.widget.model.ModelWidget;
import org.apache.ofbiz.widget.renderer.html.HtmlWidgetRenderer;
-import javax.servlet.http.HttpServletRequest;
-
/**
* A form rendering engine.
*
@@ -895,7 +895,9 @@ public class FormRenderer {
if (iter instanceof EntityListIterator) {
try {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((EntityListIterator) iter).close();
+ // CHECKSTYLE_ON: ALMOST_ALL
} catch (GenericEntityException e) {
Debug.logError(e, "Error closing list form render
EntityListIterator: " + e.toString(), MODULE);
}
@@ -1024,7 +1026,9 @@ public class FormRenderer {
List<FieldGroupBase> inbetweenList =
getInbetweenList(lastFieldGroup, currentFieldGroup);
for (FieldGroupBase obj : inbetweenList) {
if (obj instanceof ModelForm.Banner) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((ModelForm.Banner) obj).renderString(writer, context,
formStringRenderer);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
}
if (currentFieldGroup != null && (lastFieldGroup == null ||
!lastFieldGroupName.equals(currentFieldGroupName))) {
@@ -1069,7 +1073,9 @@ public class FormRenderer {
List<FieldGroupBase> inbetweenList =
getInbetweenList(lastFieldGroup, currentFieldGroup);
for (FieldGroupBase obj : inbetweenList) {
if (obj instanceof ModelForm.Banner) {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((ModelForm.Banner) obj).renderString(writer,
context, formStringRenderer);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
}
}
diff --git
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/Paginator.java
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/Paginator.java
index 41df8e1..8ca48d4 100644
---
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/Paginator.java
+++
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/Paginator.java
@@ -235,7 +235,9 @@ public final class Paginator {
// The EntityListIterator will be closed at the end of
FormRenderer.renderItemRows()
// Note: it's also used in
MacroScreenRenderer.renderScreenletPaginateMenu() but I could not find where
it's then closed, nor issues...
try {
+ // CHECKSTYLE_OFF: ALMOST_ALL
((EntityListIterator) iter).beforeFirst();
+ // CHECKSTYLE_ON: ALMOST_ALL
} catch (GenericEntityException e) {
Debug.logError(e, "Error rewinding list form render
EntityListIterator: " + e.toString(), MODULE);
}
diff --git
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/html/HtmlMenuWrapper.java
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/html/HtmlMenuWrapper.java
index 07daf77..a0bfc39 100644
---
a/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/html/HtmlMenuWrapper.java
+++
b/framework/widget/src/main/java/org/apache/ofbiz/widget/renderer/html/HtmlMenuWrapper.java
@@ -253,7 +253,9 @@ public class HtmlMenuWrapper {
*/
public void setRequest(HttpServletRequest request) {
this.request = request;
+ // CHECKSTYLE_OFF: ALMOST_ALL
((HtmlMenuRenderer) renderer).setRequest(request);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
/**
@@ -262,7 +264,9 @@ public class HtmlMenuWrapper {
*/
public void setResponse(HttpServletResponse response) {
this.response = response;
+ // CHECKSTYLE_OFF: ALMOST_ALL
((HtmlMenuRenderer) renderer).setResponse(response);
+ // CHECKSTYLE_ON: ALMOST_ALL
}
/**