Merge pull request #13 from Frodez/0.3-alpha

0.3 alpha

Author: Frodez

src/main/java/frodez/config/aop/log/annotation/DurationLog.java

@@ -5,6 +5,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import javax.validation.constraints.Positive;
 
 /**
  * 方法耗时监控注解
@@ -21,6 +22,7 @@
 	 * @author Frodez
 	 * @date 2019-04-13
 	 */
+	@Positive
 	long threshold() default 3000;
 
 }

src/main/java/frodez/config/aop/request/TimeoutAOP.java

@@ -49,9 +49,6 @@ public class TimeoutAOP {
 	public Object process(ProceedingJoinPoint point) throws Throwable {
 		HttpServletRequest request = MVCUtil.request();
 		TimeoutLock timeoutLock = AspectUtil.annotation(point, TimeoutLock.class);
-		if (timeoutLock.value() < 0) {
-			throw new IllegalArgumentException("the timeout can't be negative!");
-		}
 		String key = KeyGenerator.servletKey(AspectUtil.fullMethodName(point), request);
 		if (checker.check(key)) {
 			log.info("重复请求:IP地址{}", ServletUtil.getAddr(request));

src/main/java/frodez/config/aop/request/annotation/Limit.java

@@ -5,6 +5,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import javax.validation.constraints.Positive;
 
 /**
  * 请求限流注解,只用于controller中的端点
@@ -21,13 +22,15 @@
 	 * @author Frodez
 	 * @date 2019-04-13
 	 */
+	@Positive
 	double value() default 100.0;
 
 	/**
 	 * 超时时间,默认值3000毫秒
 	 * @author Frodez
 	 * @date 2019-04-13
 	 */
+	@Positive
 	long timeout() default 3000;
 
 }

src/main/java/frodez/config/aop/request/annotation/TimeoutLock.java

@@ -5,6 +5,7 @@
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
+import javax.validation.constraints.Positive;
 
 /**
  * 控制重复请求注解(带过期时间),只用于controller中的端点
@@ -21,6 +22,7 @@
 	 * @author Frodez
 	 * @date 2019-04-13
 	 */
+	@Positive
 	long value() default 500;
 
 }

src/main/java/frodez/config/aop/validation/ValidationAOP.java

@@ -2,7 +2,6 @@
 
 import frodez.util.aop.AspectUtil;
 import frodez.util.beans.result.Result;
-import frodez.util.common.EmptyUtil;
 import frodez.util.common.ValidationUtil;
 import org.aspectj.lang.ProceedingJoinPoint;
 import org.aspectj.lang.annotation.Around;
@@ -28,7 +27,7 @@ public class ValidationAOP {
 	@Around("@annotation(frodez.config.aop.validation.annotation.Check)")
 	public Object validate(ProceedingJoinPoint p) throws Throwable {
 		String msg = ValidationUtil.validateParam(p.getTarget(), AspectUtil.method(p), p.getArgs());
-		return EmptyUtil.yes(msg) ? p.proceed() : Result.errorRequest(msg);
+		return msg == null ? p.proceed() : Result.errorRequest(msg);
 	}
 
 }

src/main/java/frodez/config/aop/validation/annotation/common/LegalStr.java

@@ -36,6 +36,13 @@
 	 */
 	String regex();
 
+	/**
+	 * 正则表达式的模式
+	 * @see java.util.regex.Pattern
+	 * @see javax.validation.constraints.Pattern.Flag
+	 * @author Frodez
+	 * @date 2019-04-18
+	 */
 	Flag[] flags() default {};
 
 	/**
@@ -57,6 +64,9 @@ class Validator implements ConstraintValidator<LegalStr, String> {
 		 */
 		private String regex;
 
+		/**
+		 * 正则表达式的模式
+		 */
 		private int flag;
 
 		/**

src/main/java/frodez/config/aop/validation/package-info.java

@@ -1,6 +1,7 @@
 /**
  * 本包用于配置方法参数自动验证。<br>
  * 使用hibernate-validation框架进行验证。<br>
+ * <strong>本包中的自定义注解使用后,相当于默认添加了@NotNull注解。如果需要关闭此功能,请在自定义注解的属性中设定nullable为true。</strong>
  * @author Frodez
  * @date 2019-03-11
  */

src/main/java/frodez/config/async/AsyncConfig.java

@@ -0,0 +1,44 @@
+package frodez.config.async;
+
+import frodez.util.spring.ContextUtil;
+import java.util.concurrent.Executor;
+import java.util.concurrent.ThreadPoolExecutor;
+import lombok.extern.slf4j.Slf4j;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import org.springframework.scheduling.annotation.EnableAsync;
+import org.springframework.scheduling.concurrent.ThreadPoolTaskExecutor;
+
+/**
+ * 异步配置
+ * @author Frodez
+ * @date 2019-04-15
+ */
+@Slf4j
+@EnableAsync
+@Configuration
+public class AsyncConfig {
+
+	@Bean
+	public Executor getAsyncExecutor() {
+		AsyncProperties properties = ContextUtil.get(AsyncProperties.class);
+		ThreadPoolTaskExecutor executor = new ThreadPoolTaskExecutor();
+		int availableProcessors = Runtime.getRuntime().availableProcessors();
+		int corePoolSize = Math.round(availableProcessors * properties.getCoreThreadTimes());
+		int maxPoolSize = Math.round(availableProcessors * properties.getMaxThreadTimes());
+		int queueCapacity = Math.round(maxPoolSize * properties.getQueueFactors());
+		executor.setCorePoolSize(corePoolSize);
+		executor.setMaxPoolSize(maxPoolSize);
+		executor.setQueueCapacity(queueCapacity);
+		executor.setKeepAliveSeconds(properties.getKeepAliveSeconds());
+		executor.setThreadNamePrefix(properties.getThreadNamePrefix());
+		executor.setRejectedExecutionHandler(new ThreadPoolExecutor.CallerRunsPolicy());
+		executor.initialize();
+		log.info("async executor is running now!");
+		log.info("async config:{}corePoolSize, {}maxPoolSize, {}queueCapacity, {}keepAliveSeconds, {}threadNamePrefix",
+			corePoolSize, maxPoolSize, queueCapacity, properties.getKeepAliveSeconds(), properties
+				.getThreadNamePrefix());
+		return executor;
+	}
+
+}

src/main/java/frodez/config/async/AsyncProperties.java

@@ -0,0 +1,44 @@
+package frodez.config.async;
+
+import lombok.Data;
+import org.springframework.boot.context.properties.ConfigurationProperties;
+import org.springframework.context.annotation.PropertySource;
+import org.springframework.stereotype.Component;
+
+/**
+ * 异步任务配置
+ * @author Frodez
+ * @date 2019-04-15
+ */
+@Data
+@Component
+@PropertySource(value = { "classpath:settings/${spring.profiles.active}/async.properties" })
+@ConfigurationProperties(prefix = "async")
+public class AsyncProperties {
+
+	/**
+	 * 核心线程基数,实际数量等于系统环境可用核心数乘以该基数并四舍五入。
+	 */
+	private float coreThreadTimes = 0.5F;
+
+	/**
+	 * 最大线程基数,实际数量等于系统环境可用核心数乘以该基数并四舍五入。
+	 */
+	private float maxThreadTimes = 1.0F;
+
+	/**
+	 * 队列规模因子,队列最大长度等于计算出的最大线程数乘以规模因子并四舍五入。
+	 */
+	private float queueFactors = 16.0F;
+
+	/**
+	 * 线程最长活跃时间,单位为秒
+	 */
+	private int keepAliveSeconds = 60;
+
+	/**
+	 * 线程名前缀
+	 */
+	private String threadNamePrefix = "async";
+
+}

src/main/java/frodez/config/cache/CacheProperties.java

@@ -16,49 +16,82 @@
 @ConfigurationProperties(prefix = "cache")
 public class CacheProperties {
 
+	/**
+	 * 标准配置
+	 */
 	private StandardProperties standard = new StandardProperties();
 
+	/**
+	 * AutoGuavaChecker配置
+	 */
 	private AutoGuavaCheckerProperties autoGuavaChecker = new AutoGuavaCheckerProperties();
 
+	/**
+	 * ManualGuavaChecker配置
+	 */
 	private ManualGuavaCheckerProperties manualGuavaChecker = new ManualGuavaCheckerProperties();
 
+	/**
+	 * LimitUserGuavaChecker配置
+	 */
 	private LimitUserGuavaCheckerProperties limitUserGuavaChecker = new LimitUserGuavaCheckerProperties();
 
+	/**
+	 * URLMatcher配置
+	 */
 	private URLMatcherProperties urlMatcher = new URLMatcherProperties();
 
 	@Data
 	public static class StandardProperties {
 
+		/**
+		 * 超时时间,单位毫秒
+		 */
 		private Integer timeout = 60000;
 
 	}
 
 	@Data
 	public static class AutoGuavaCheckerProperties {
 
+		/**
+		 * 超时时间,单位毫秒
+		 */
 		private Integer timeout = 60000;
 
 	}
 
 	@Data
 	public static class ManualGuavaCheckerProperties {
 
+		/**
+		 * 超时时间,单位毫秒
+		 */
 		private Integer timeout = 60000;
 
 	}
 
 	@Data
 	public static class LimitUserGuavaCheckerProperties {
 
+		/**
+		 * 超时时间,单位毫秒
+		 */
 		private Integer timeout = 60000;
 
 	}
 
 	@Data
 	public static class URLMatcherProperties {
 
+		/**
+		 * 超时时间,单位毫秒
+		 */
 		private Integer timeout = 3600000;
 
+		/**
+		 * 缓存最大容量
+		 */
 		private Integer maxSize = 65536;
 
 	}