INT-3262 JDK8 Javadoc Commit

Increase receive timeout for `Jsr223TransformerTests#testInt3162ScriptExecutorThreadSafety`.

JIRA: https://jira.springsource.org/browse/INT-3262
JIRA: https://jira.springsource.org/browse/INT-3263

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/AttributePollingMessageSource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -20,10 +20,10 @@ import javax.management.MBeanServerConnection;
 import javax.management.MalformedObjectNameException;
 import javax.management.ObjectName;
 
-import org.springframework.messaging.MessagingException;
 import org.springframework.integration.core.MessageSource;
 import org.springframework.integration.endpoint.AbstractMessageSource;
 import org.springframework.jmx.support.ObjectNameManager;
+import org.springframework.messaging.MessagingException;
 import org.springframework.util.Assert;
 
 /**
@@ -45,6 +45,8 @@ public class AttributePollingMessageSource extends AbstractMessageSource<Object>
 
 	/**
 	 * Provide the MBeanServer where the JMX MBean has been registered.
+	 *
+	 * @param server The MBean server connection.
 	 */
 	public void setServer(MBeanServerConnection server) {
 		this.server = server;
@@ -52,6 +54,8 @@ public class AttributePollingMessageSource extends AbstractMessageSource<Object>
 
 	/**
 	 * Specify the String value of the JMX MBean's {@link ObjectName}.
+	 *
+	 * @param objectName The object name.
 	 */
 	public void setObjectName(String objectName) {
 		try {
@@ -64,6 +68,8 @@ public class AttributePollingMessageSource extends AbstractMessageSource<Object>
 
 	/**
 	 * Specify the name of the attribute to be retrieved.
+	 *
+	 * @param attributeName The attribute name.
 	 */
 	public void setAttributeName(String attributeName) {
 		this.attributeName = attributeName;

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/MBeanAttributeFilter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 the original author or authors.
+ * Copyright 2013-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -25,9 +25,9 @@ import javax.management.ObjectName;
 public interface MBeanAttributeFilter {
 
 	/**
-	 * @param objectName
-	 * @param attributeName
-	 * @return outcome of test
+	 * @param objectName The object name.
+	 * @param attributeName The attribute name.
+	 * @return true if the attribute passes the filter.
 	 */
 	boolean accept(ObjectName objectName, String attributeName);
 

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/MBeanObjectConverter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 the original author or authors.
+ * Copyright 2013-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -27,9 +27,9 @@ import javax.management.ObjectInstance;
 public interface MBeanObjectConverter {
 
 	/**
-	 * @param connection
-	 * @param instance
-	 * @return mapped object instance
+	 * @param connection The connection.
+	 * @param instance The instance.
+	 * @return The mapped object instance.
 	 */
 	Object convert(MBeanServerConnection connection, ObjectInstance instance);
 

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/MBeanTreePollingMessageSource.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 the original author or authors.
+ * Copyright 2013-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -48,7 +48,7 @@ public class MBeanTreePollingMessageSource extends AbstractMessageSource<Object>
 	private final MBeanObjectConverter converter;
 
 	/**
-	 * @param converter
+	 * @param converter The converter.
 	 */
 	public MBeanTreePollingMessageSource(MBeanObjectConverter converter) {
 		this.converter = converter;
@@ -80,13 +80,15 @@ public class MBeanTreePollingMessageSource extends AbstractMessageSource<Object>
 
 	/**
 	 * Provide the MBeanServer where the JMX MBean has been registered.
+	 *
+	 * @param server The MBean server connection.
 	 */
 	public void setServer(MBeanServerConnection server) {
 		this.server = server;
 	}
 
 	/**
-	 * @param queryName
+	 * @param queryName The query name.
 	 */
 	public void setQueryName(String queryName) {
 		Assert.notNull(queryName, "'queryName' must not be null");
@@ -99,14 +101,14 @@ public class MBeanTreePollingMessageSource extends AbstractMessageSource<Object>
 	}
 
 	/**
-	 * @param queryName
+	 * @param queryName The query name.
 	 */
 	public void setQueryNameReference(ObjectName queryName) {
 		this.queryName = queryName;
 	}
 
 	/**
-	 * @param queryExpression
+	 * @param queryExpression The query expression.
 	 */
 	public void setQueryExpression(String queryExpression) {
 		Assert.notNull(queryExpression, "'queryExpression' must not be null");
@@ -119,7 +121,7 @@ public class MBeanTreePollingMessageSource extends AbstractMessageSource<Object>
 	}
 
 	/**
-	 * @param queryExpression
+	 * @param queryExpression The query expression.
 	 */
 	public void setQueryExpressionReference(QueryExp queryExpression) {
 		this.queryExpression = queryExpression;

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/NamedFieldsMBeanAttributeFilter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 the original author or authors.
+ * Copyright 2013-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,7 +29,7 @@ public class NamedFieldsMBeanAttributeFilter implements MBeanAttributeFilter {
 	private final String[] namedFields;
 
 	/**
-	 * @param namedFields
+	 * @param namedFields The named fields that should pass the filter.
 	 */
 	public NamedFieldsMBeanAttributeFilter(String... namedFields) {
 		this.namedFields = (String[]) Arrays.asList(namedFields).toArray();

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/NotNamedFieldsMBeanAttributeFilter.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2013 the original author or authors.
+ * Copyright 2013-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,7 +29,7 @@ public class NotNamedFieldsMBeanAttributeFilter implements MBeanAttributeFilter
 	private final String[] namedFields;
 
 	/**
-	 * @param namedFields
+	 * @param namedFields The named fields that should be filtered.
 	 */
 	public NotNamedFieldsMBeanAttributeFilter(String... namedFields) {
 		this.namedFields = (String[]) Arrays.asList(namedFields).toArray();

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/NotificationListeningMessageProducer.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2012 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -34,9 +34,10 @@ import javax.management.ObjectName;
 
 import org.apache.commons.logging.Log;
 import org.apache.commons.logging.LogFactory;
-import org.springframework.messaging.Message;
+
 import org.springframework.integration.endpoint.MessageProducerSupport;
 import org.springframework.integration.support.MessageBuilder;
+import org.springframework.messaging.Message;
 import org.springframework.util.Assert;
 import org.springframework.util.ObjectUtils;
 
@@ -64,6 +65,8 @@ public class NotificationListeningMessageProducer extends MessageProducerSupport
 	/**
 	 * Provide a reference to the MBeanServer where the notification
 	 * publishing MBeans are registered.
+	 *
+	 * @param server the MBean server connection.
 	 */
 	public void setServer(MBeanServerConnection server) {
 		this.server = server;
@@ -73,6 +76,8 @@ public class NotificationListeningMessageProducer extends MessageProducerSupport
 	 * Specify the JMX ObjectNames (or patterns)
 	 * of the notification publisher
 	 * to which this notification listener should be subscribed.
+	 *
+	 * @param objectNames The object names.
 	 */
 	public void setObjectName(ObjectName... objectNames) {
 		Assert.isTrue(!ObjectUtils.isEmpty(objectNames), "'objectNames' must contain at least one ObjectName");
@@ -82,6 +87,8 @@ public class NotificationListeningMessageProducer extends MessageProducerSupport
 	/**
 	 * Specify a {@link NotificationFilter} to be passed to the server
 	 * when registering this listener. The filter may be null.
+	 *
+	 * @param filter The filter.
 	 */
 	public void setFilter(NotificationFilter filter) {
 		this.filter = filter;
@@ -90,6 +97,8 @@ public class NotificationListeningMessageProducer extends MessageProducerSupport
 	/**
 	 * Specify a handback object to provide context to the listener
 	 * upon notification. This object may be null.
+	 *
+	 * @param handback The object.
 	 */
 	public void setHandback(Object handback) {
 		this.handback = handback;
@@ -101,6 +110,7 @@ public class NotificationListeningMessageProducer extends MessageProducerSupport
 	 * not null, it sets that as a Message header value. The Message is then
 	 * sent to this producer's output channel.
 	 */
+	@Override
 	public void handleNotification(Notification notification, Object handback) {
 		if (logger.isInfoEnabled()) {
 			logger.info("received notification: " + notification + ", and handback: " + handback);

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/NotificationPublishingMessageHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -26,7 +26,6 @@ import org.springframework.beans.factory.BeanFactoryAware;
 import org.springframework.beans.factory.BeanFactoryUtils;
 import org.springframework.beans.factory.InitializingBean;
 import org.springframework.beans.factory.ListableBeanFactory;
-import org.springframework.messaging.Message;
 import org.springframework.integration.handler.AbstractMessageHandler;
 import org.springframework.integration.mapping.OutboundMessageMapper;
 import org.springframework.integration.monitor.IntegrationMBeanExporter;
@@ -35,6 +34,7 @@ import org.springframework.jmx.export.annotation.ManagedResource;
 import org.springframework.jmx.export.notification.NotificationPublisher;
 import org.springframework.jmx.export.notification.NotificationPublisherAware;
 import org.springframework.jmx.support.ObjectNameManager;
+import org.springframework.messaging.Message;
 import org.springframework.util.Assert;
 
 /**
@@ -74,6 +74,8 @@ public class NotificationPublishingMessageHandler extends AbstractMessageHandler
 	 * a default implementation will be used such that String-typed payloads will be
 	 * passed as the 'message' of the Notification and all other payload types
 	 * will be passed as the 'userData' of the Notification.
+	 *
+	 * @param notificationMapper The notification mapper.
 	 */
 	public void setNotificationMapper(OutboundMessageMapper<Notification> notificationMapper) {
 		this.notificationMapper = notificationMapper;
@@ -84,6 +86,8 @@ public class NotificationPublishingMessageHandler extends AbstractMessageHandler
 	 * use by default when <em>no</em> explicit Notification mapper
 	 * has been configured. If not provided, then a notification type header will
 	 * be required for each message being mapped into a Notification.
+	 *
+	 * @param defaultNotificationType The default notification type.
 	 */
 	public void setDefaultNotificationType(String defaultNotificationType) {
 		this.defaultNotificationType = defaultNotificationType;
@@ -125,6 +129,7 @@ public class NotificationPublishingMessageHandler extends AbstractMessageHandler
 
 		private volatile NotificationPublisher notificationPublisher;
 
+		@Override
 		public void setNotificationPublisher(NotificationPublisher notificationPublisher) {
 			this.notificationPublisher = notificationPublisher;
 		}

spring-integration-jmx/src/main/java/org/springframework/integration/jmx/OperationInvokingMessageHandler.java

@@ -1,5 +1,5 @@
 /*
- * Copyright 2002-2013 the original author or authors.
+ * Copyright 2002-2014 the original author or authors.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -32,11 +32,11 @@ import javax.management.MalformedObjectNameException;
 import javax.management.ObjectName;
 
 import org.springframework.beans.factory.InitializingBean;
-import org.springframework.messaging.MessageHandlingException;
 import org.springframework.integration.handler.AbstractReplyProducingMessageHandler;
 import org.springframework.integration.util.ClassUtils;
 import org.springframework.jmx.support.ObjectNameManager;
 import org.springframework.messaging.Message;
+import org.springframework.messaging.MessageHandlingException;
 import org.springframework.messaging.MessagingException;
 import org.springframework.util.Assert;
 import org.springframework.util.ObjectUtils;
@@ -72,6 +72,8 @@ public class OperationInvokingMessageHandler extends AbstractReplyProducingMessa
 	/**
 	 * Provide a reference to the MBeanServer within which the MBean
 	 * target for operation invocation has been registered.
+	 *
+	 * @param server The MBean server connection.
 	 */
 	public void setServer(MBeanServerConnection server) {
 		this.server = server;
@@ -80,6 +82,8 @@ public class OperationInvokingMessageHandler extends AbstractReplyProducingMessa
 	/**
 	 * Specify a default ObjectName to use when no such header is
 	 * available on the Message being handled.
+	 *
+	 * @param objectName The object name.
 	 */
 	public void setObjectName(String objectName) {
 		try {
@@ -95,6 +99,8 @@ public class OperationInvokingMessageHandler extends AbstractReplyProducingMessa
 	/**
 	 * Specify an operation name to be invoked when no such
 	 * header is available on the Message being handled.
+	 *
+	 * @param operationName The operation name.
 	 */
 	public void setOperationName(String operationName) {
 		this.operationName = operationName;