Merge branch 'master' into dev

doc/platform.md

@@ -270,7 +270,7 @@ litemall_region表保存了行政区域信息，包括省级、市级、县级
 如果用户没有支付，也没有点击`取消订单`按钮，那么系统会定时查询数据库的订单信息。
 如果发现存在订单未支付状态超时半小时，此时系统会自动取消订单，来释放商品资源。
 
-所对应的后台服务方法是litemall-admin-api模块的`AdminOrderController.checkOrderUnpaid`
+对应的应该是litemall-admin-api模块的系统定时任务的`OrderJob.checkOrderUnpaid`
 
 * 101 -> 201
 
@@ -314,7 +314,7 @@ litemall_region表保存了行政区域信息，包括省级、市级、县级
 当管理员发货以后，用户一直没有确认收货，系统定时检测订单状态，如果发现发货以后
 七天用户都没有收货，此时系统自动确认用户收货，设置订单状态402。
 
-所对应的后台服务方法是litemall-admin-api模块的`AdminOrderController.checkOrderUnpaid`
+应该改为 litemall-admin-api模块的系统定时任务`OrderJob.checkOrderUnconfirm`
 
 注意：
 > 上述订单状态变化中具体的逻辑处理可以参考相应模块文档和模块代码。
@@ -1153,7 +1153,7 @@ public interface Storage {
 
 ## 2.4 litemall-all
 
-在章节1.5中讨论的部署方案中设计了一种单主机单服务方案，
+在章节1.5中讨论的部署方案中设计了一种单服务器单服务方案，
 也就是说两个后台服务和静态文件都部署在一个Spring Boot可执行jar包中。
 
 查看litemall-all模块，代码仅仅只有一个Application类。

doc/wxmall.md

@@ -12,7 +12,6 @@
 
 目前发现存在的一些问题：
   
-* `缺失`优惠券功能
 * `缺失`商品评价中管理员回复功能，进一步地用户之间相互评价回复
 * `缺失`后台服务返回的token存在有效期，小商场应该自动刷新
 * `缺失`账号多次登录失败，应该小商城出现图片验证码限制，或者后台账号锁定
@@ -29,9 +28,6 @@
 * `改善`个人页面中实现订单部件，显示用户订单数量，同时点击以后跳转到订单的相应页面。
 * `改善`商品的订单中支持订单号搜索功能
 * `改善`在一些内容比较多的页面中支持“顶部”功能
-* `功能`目前已经有账号登录页面，可以再支持手机短信登录方式。
-* `功能`个人页面支持帮助中心
-* `功能`推荐功能，基于用户的一些信息，在合适的页面给出推荐商品
 
 ## 3.0 小商场环境
 
@@ -87,9 +83,9 @@
 
 2. 启动后台服务
 
-3. 部署后台服务到云主机
+3. 部署后台服务到云服务器
 
-4. litemall-wx的api.js设置云主机的域名。
+4. litemall-wx的api.js设置云服务器的域名。
    编译运行，尝试微信支付。
    
 ### 3.0.3 微信退款配置
@@ -240,14 +236,14 @@ var WxApiRoot = 'http://localhost:8082/wx/';
 // 局域网测试使用
 // var WxApiRoot = 'http://192.168.0.101:8082/wx/';
 // 云平台部署时使用
-//  var WxApiRoot = 'http://118.24.0.153:8082/wx/';
+//  var WxApiRoot = 'http://122.51.199.160:8082/wx/';
 ```
 
 也就是说这里存在三种类型的API服务地址，这里是考虑到开发存在三种情况：
 
 1. 本机开发时，localhost是当前开发机的地址；
 2. 手机预览时，192.168.0.101是开发机的IP地址；
-3. 当后台部署在云主机中时，118.24.0.153是云主机的IP地址；
+3. 当后台部署在云服务器中时，122.51.199.160是云服务器的IP地址；
 4. 此外，更最重要的是，如果小程序正式部署时，这里的地址必须是域名，
 而不能是IP地址。
 

litemall-admin-api/pom.xml

@@ -9,7 +9,10 @@
         <artifactId>litemall</artifactId>
         <version>0.1.0</version>
     </parent>
-
+    <properties>
+        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
+        <project.reporting.outputEncoding>UTF-8</project.reporting.outputEncoding>
+    </properties>
     <dependencies>
 
         <dependency>
@@ -21,39 +24,22 @@
             <groupId>org.linlinjava</groupId>
             <artifactId>litemall-db</artifactId>
         </dependency>
-
         <dependency>
             <groupId>com.github.binarywang</groupId>
             <artifactId>weixin-java-miniapp</artifactId>
         </dependency>
-
+        <dependency>
+            <groupId>io.springfox</groupId>
+            <artifactId>springfox-swagger-ui</artifactId>
+        </dependency>
+        <dependency>
+            <groupId>io.springfox</groupId>
+            <artifactId>springfox-swagger2</artifactId>
+        </dependency>
         <dependency>
             <groupId>org.apache.shiro</groupId>
             <artifactId>shiro-spring-boot-web-starter</artifactId>
         </dependency>
     </dependencies>
 
-    <build>
-        <plugins>
-            <plugin>
-                <groupId>org.springframework.boot</groupId>
-                <artifactId>spring-boot-maven-plugin</artifactId>
-                <configuration>
-                    <executable>true</executable>
-                </configuration>
-                <executions>
-                    <execution>
-                        <goals>
-                            <goal>repackage</goal>
-                        </goals>
-                        <configuration>
-                            <classifier>exec</classifier>
-                        </configuration>
-                    </execution>
-                </executions>
-            </plugin>
-        </plugins>
-    </build>
-
-
 </project>
\ No newline at end of file

litemall-admin-api/src/main/java/org/linlinjava/litemall/admin/Application.java

@@ -6,7 +6,8 @@ import org.springframework.boot.autoconfigure.SpringBootApplication;
 import org.springframework.scheduling.annotation.EnableScheduling;
 import org.springframework.transaction.annotation.EnableTransactionManagement;
 
-@SpringBootApplication(scanBasePackages = {"org.linlinjava.litemall.db", "org.linlinjava.litemall.core", "org.linlinjava.litemall.admin"})
+@SpringBootApplication(scanBasePackages = {"org.linlinjava.litemall.db", "org.linlinjava.litemall.core", "org" +
+        ".linlinjava.litemall.admin"})
 @MapperScan("org.linlinjava.litemall.db.dao")
 @EnableTransactionManagement
 @EnableScheduling

litemall-admin-api/src/main/java/org/linlinjava/litemall/admin/annotation/RequiresPermissionsDesc.java

 package org.linlinjava.litemall.admin.annotation;
 
-import org.apache.shiro.authz.annotation.RequiresPermissions;
-
 import java.lang.annotation.ElementType;
 import java.lang.annotation.Retention;
 import java.lang.annotation.RetentionPolicy;
@@ -11,5 +9,6 @@ import java.lang.annotation.Target;
 @Retention(RetentionPolicy.RUNTIME)
 public @interface RequiresPermissionsDesc {
     String[] menu();
+
     String button();
 }

litemall-admin-api/src/main/java/org/linlinjava/litemall/admin/config/AdminSwagger2Configuration.java

+package org.linlinjava.litemall.admin.config;
+
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import springfox.documentation.builders.ApiInfoBuilder;
+import springfox.documentation.builders.PathSelectors;
+import springfox.documentation.builders.RequestHandlerSelectors;
+import springfox.documentation.service.ApiInfo;
+import springfox.documentation.spi.DocumentationType;
+import springfox.documentation.spring.web.plugins.Docket;
+import springfox.documentation.swagger2.annotations.EnableSwagger2;
+
+/**
+ * swagger在线文档配置<br>
+ * 项目启动后可通过地址：http://host:ip/swagger-ui.html 查看在线文档
+ *
+ * @author enilu
+ * @version 2018-07-24
+ */
+
+@Configuration
+@EnableSwagger2
+public class AdminSwagger2Configuration {
+    @Bean
+    public Docket adminDocket() {
+
+        return new Docket(DocumentationType.SWAGGER_2)
+                .groupName("admin")
+                .apiInfo(adminApiInfo())
+                .select()
+                .apis(RequestHandlerSelectors.basePackage("org.linlinjava.litemall.admin.web"))
+                .paths(PathSelectors.any())
+                .build();
+    }
+
+    private ApiInfo adminApiInfo() {
+        return new ApiInfoBuilder()
+                .title("litemall-admin API")
+                .description("litemall管理后台API")
+                .termsOfServiceUrl("https://github.com/linlinjava/litemall")
+                .contact("https://github.com/linlinjava/litemall")
+                .version("1.0")
+                .build();
+    }
+}

litemall-admin-api/src/main/java/org/linlinjava/litemall/admin/config/ShiroExceptionHandler.java

 package org.linlinjava.litemall.admin.config;
 
+import org.apache.commons.logging.Log;
+import org.apache.commons.logging.LogFactory;
 import org.apache.shiro.authc.AuthenticationException;
 import org.apache.shiro.authz.AuthorizationException;
 import org.linlinjava.litemall.core.util.ResponseUtil;
@@ -10,20 +12,22 @@ import org.springframework.web.bind.annotation.ExceptionHandler;
 import org.springframework.web.bind.annotation.ResponseBody;
 
 @ControllerAdvice
-@Order( value = Ordered.HIGHEST_PRECEDENCE )
+@Order(value = Ordered.HIGHEST_PRECEDENCE)
 public class ShiroExceptionHandler {
 
+    private final Log logger = LogFactory.getLog(ShiroExceptionHandler.class);
+
     @ExceptionHandler(AuthenticationException.class)
     @ResponseBody
     public Object unauthenticatedHandler(AuthenticationException e) {
-        e.printStackTrace();
+        logger.warn(e.getMessage(), e);
         return ResponseUtil.unlogin();
     }
 
     @ExceptionHandler(AuthorizationException.class)
     @ResponseBody
     public Object unauthorizedHandler(AuthorizationException e) {
-        e.printStackTrace();
+        logger.warn(e.getMessage(), e);
         return ResponseUtil.unauthz();
     }