diff --git a/convert.html b/convert.html index 6b6fd3d67..35accc6a4 100644 --- a/convert.html +++ b/convert.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -72,7 +72,7 @@ resp.getOutputStream().write(json.getBytes("UTF-8")); }

        几乎所有的JSON框架提供的接口以String作为返回结果为主，其内在都是以char[]作为JsonWriter的载体。以Gson为例，Gson拼接JSON默认使用的是StringWriter，StringWriter的扩容策略是翻倍。为了方便计算，假设一个对象转换成JSON字符串大小为了10K。Gson在转换过程中产生的临时的char[]的大小: 16 + 32 + 64 + 128 + 256 + 512 + 1K + 2K + 4K + 8K + 16K = 32K, char[]转换成最终的String结果又会产生10K的char[], 最后在response输出时又会产生10K的byte[]（方便计算不考虑双字节）,也就是说整个对象输出过程中会产生52K的临时数据。而且常见的HTTP服务器(如实现java-servlet规范的服务器)不会把底层的ByteBuffer对象池暴露给上层。所以以String为输出结果的JSON方法都会产生5倍于数据体积大小(其他低于1倍扩容策略的框架会产生更多)的垃圾数据。
-         RedKale框架的HTTP服务内置了Convert的JSON接口，避免了大量的垃圾数据产生。RedKale的HTTP是基于AIO(NIO.2)实现且存在ByteBuffer对象池，response的finishJson系列方法将HTTP服务的ByteBuffer对象池传给Convert， 使Convert在序列化过程中直接以UTF-8编码方式输出到ByteBuffer里，输出结束后将ByteBuffer交给对象池回收，从而减少大量构建bye[]、char[]所产生的临时数据。

+         Redkale框架的HTTP服务内置了Convert的JSON接口，避免了大量的垃圾数据产生。Redkale的HTTP是基于AIO(NIO.2)实现且存在ByteBuffer对象池，response的finishJson系列方法将HTTP服务的ByteBuffer对象池传给Convert， 使Convert在序列化过程中直接以UTF-8编码方式输出到ByteBuffer里，输出结束后将ByteBuffer交给对象池回收，从而减少大量构建bye[]、char[]所产生的临时数据。

    protected void execute(HttpRequest req, HttpResponse resp) throws IOException {
         resp.finishJson(record);
     }
@@ -122,7 +122,7 @@ user2 = childConvert.convertFrom(UserRecord.class, json); System.out.println(childConvert.convertTo(user2)); //应该也是 {"userid":100,"username":"redkalename"} } -

        在RedKale里存在默认的JsonConvert、BsonConvert对象。 只需在所有Service、Servlet中增加依赖注入资源。

+

        在Redkale里存在默认的JsonConvert、BsonConvert对象。 只需在所有Service、Servlet中增加依赖注入资源。

public class XXXService implements Service {
 
     @Resource
@@ -415,7 +415,7 @@
                                         6. SIGN_OBJECTE 标记位，值固定为0xEE (short)
diff --git a/index.html b/index.html index 2c0b851db..5e2863bde 100644 --- a/index.html +++ b/index.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -27,11 +27,11 @@

- RedKale 介绍

+ Redkale 介绍 -

        RedKale (中文名: 红菜苔，湖北武汉的一种特产蔬菜) 是基于Java 8全新的微服务框架， 包含HTTP、WebSocket、TCP/UDP、数据序列化、数据缓存、依赖注入等功能。 +

        Redkale (中文名: 红菜苔，湖北武汉的一种特产蔬菜) 是基于Java 8全新的微服务框架， 包含HTTP、WebSocket、TCP/UDP、数据序列化、数据缓存、依赖注入等功能。 本框架致力于简化集中式和微服务架构的开发，在增强开发敏捷性的同时保持高性能。
- RedKale 有如下主要特点：
+ Redkale 有如下主要特点：
        1、大量使用Java 8新特性（接口默认值、Stream、Lambda、JDk8内置的ASM等）
        2、提供HTTP服务，同时内置JSON功能与限时缓存功能
        3、TCP层完全使用NIO.2，并统一TCP与UDP的接口
@@ -43,26 +43,26 @@

-

        Convert包是RedKale内一个独立的组件， 用于数据的序列化与反序列化。包分三块：基本包、JSON包、BSON(Binary Stream Object Notation)包。基本包可以用于扩展其他序列化格式(如: XML)，其JSON性能是其他任何JSON框架不能媲美的，对于非常规的POJO类也提供了方便的自定义接口。BSON用于数据的二进制序列化与反序列化，支持很复杂的泛型数据，是SNCP协议的基础。

+

        Convert包是Redkale内一个独立的组件， 用于数据的序列化与反序列化。包分三块：基本包、JSON包、BSON(Binary Stream Object Notation)包。基本包可以用于扩展其他序列化格式(如: XML)，其JSON性能是其他任何JSON框架不能媲美的，对于非常规的POJO类也提供了方便的自定义接口。BSON用于数据的二进制序列化与反序列化，支持很复杂的泛型数据，是SNCP协议的基础。

-

        RedKale 的HTTP是基于异步NIO.2实现的，所提供的HttpResponse的输出接口也是异步的，因此并不遵循JSR 340规范(Servlet 3.1)且也没有实现JSP规范。 HTTP只提供四个对象：HttpContext、HttpRequest、HttpResponse、HttpServlet。 传统Session则由数据层实现。RedKale提倡HTTP+JSON接口(无论网站、PC客户端、APP移动端、第三方接口都可使用统一接口)， 因此HTTP层内置了JSON序列化与反序列化接口，同时内置HTTP缓存机制。
-       RedKale 的WebSocket服务接口不同于JSR 340(Servlet 3.1)， 除了提供基本的WebSocket功能， 还提供分布式与集中式部署， 当部署多个WebSocket进程时，通过配置文件可以实现WebSocket之间连接信息的数据同步。

+

        Redkale 的HTTP是基于异步NIO.2实现的，所提供的HttpResponse的输出接口也是异步的，因此并不遵循JSR 340规范(Servlet 3.1)且也没有实现JSP规范。 HTTP只提供四个对象：HttpContext、HttpRequest、HttpResponse、HttpServlet。 传统Session则由数据层实现。Redkale提倡HTTP+JSON接口(无论网站、PC客户端、APP移动端、第三方接口都可使用统一接口)， 因此HTTP层内置了JSON序列化与反序列化接口，同时内置HTTP缓存机制。
+       Redkale 的WebSocket服务接口不同于JSR 340(Servlet 3.1)， 除了提供基本的WebSocket功能， 还提供分布式与集中式部署， 当部署多个WebSocket进程时，通过配置文件可以实现WebSocket之间连接信息的数据同步。

-

        SNCP(Service Node Communicate Protocol)是RedKale独有的协议， 类似RMI与WebService的功能结合，主要用于进程间的数据传输。使用者通过配置文件可以轻易的将Service由本地模式变成远程模式。远程模式Service使用SNCP协议与其他进程的Service通信。使用者无需对远程通信接口使用类似Mina的第三方包自行开发。SNCP是RedKale的核心功能，其微服务架构都是基于本地模式Service和远程模式Service。

+

        SNCP(Service Node Communicate Protocol)是Redkale独有的协议， 类似RMI与WebService的功能结合，主要用于进程间的数据传输。使用者通过配置文件可以轻易的将Service由本地模式变成远程模式。远程模式Service使用SNCP协议与其他进程的Service通信。使用者无需对远程通信接口使用类似Mina的第三方包自行开发。SNCP是Redkale的核心功能，其微服务架构都是基于本地模式Service和远程模式Service。

-

        RedKale提供DataSource类对数据层进行操作，其功能类似JPA+Memcached。最大程度的简化数据层的操作，免去SQL/JPQL语句的编写。同时提供过滤查询与JavaBean的结合、读写分离、数据库热切换、本地/远程部署、进程间缓存自动同步等功能。

+

        Redkale提供DataSource类对数据层进行操作，其功能类似JPA+Memcached。最大程度的简化数据层的操作，免去SQL/JPQL语句的编写。同时提供过滤查询与JavaBean的结合、读写分离、数据库热切换、本地/远程部署、进程间缓存自动同步等功能。

- RedKale ©     欢迎加入RedKale技术交流QQ群: 527523235 + Redkale ©     欢迎加入Redkale技术交流QQ群: 527523235
diff --git a/net.html b/net.html index 0bf4c6fd9..38b56d91a 100644 --- a/net.html +++ b/net.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -27,10 +27,10 @@

Net 组件介绍

-

        Net 组件是基于AIO(NIO.2)的一套TCP/UDP的网络框架，且只提供异步接口。org.redkale.net 是所有网络协议服务的基础包。RedKale内置HTTP和远程模式Service依赖的SNCP(Service Node Communicate Protocol)协议的实现包。RedKale启动的<server>节点服务都是基于Net组件实现的协议。下面详细介绍 HTTP服务 和 SNCP协议。

+

        Net 组件是基于AIO(NIO.2)的一套TCP/UDP的网络框架，且只提供异步接口。org.redkale.net 是所有网络协议服务的基础包。Redkale内置HTTP和远程模式Service依赖的SNCP(Service Node Communicate Protocol)协议的实现包。Redkale启动的<server>节点服务都是基于Net组件实现的协议。下面详细介绍 HTTP服务 和 SNCP协议。

HTTP 服务

-

        RedKale自实现的HTTP服务接口并不遵循Java EE规范JSR 340(Servlet 3.1)，RedKale提倡的是HTTP+JSON的服务接口方式因此没有实现JSP规范，HTTP+JSON服务接口几乎适合所有类型的客户端(PC应用程序、PC Web、微信H5、移动APP、移动Web)开发。其与JSR 340(Servlet 3.1)的主要区别如下：
+

        Redkale自实现的HTTP服务接口并不遵循Java EE规范JSR 340(Servlet 3.1)，Redkale提倡的是HTTP+JSON的服务接口方式因此没有实现JSP规范，HTTP+JSON服务接口几乎适合所有类型的客户端(PC应用程序、PC Web、微信H5、移动APP、移动Web)开发。其与JSR 340(Servlet 3.1)的主要区别如下：
                1、内置参数的JSON反序列化和响应结果的序列化接口。
                2、对数值型的参数和header值提供简易接口。
                3、不支持JSP，提倡的是HTTP+JSON接口方式。
@@ -40,7 +40,7 @@                 7、内置WebSocket的集群与组功能，且提供伪WebSocket连接功能。
                8、HttpResponse只能异步输出。

-

        编写RedKale的HttpServlet与 JSR 340中的javax.servlet.http.HttpServlet 基本相同，只需继承 org.redkale.net.http.HttpServlet, Redkale也提供了更友好的基类 org.redkale.net.http.BasedHttpServlet, 比较好的习惯是一个项目先定义一个项目级的BaseServlet类，这样方便以后加入类似javax.servlet.Filter的功能。

+

        编写Redkale的HttpServlet与 JSR 340中的javax.servlet.http.HttpServlet 基本相同，只需继承 org.redkale.net.http.HttpServlet, Redkale也提供了更友好的基类 org.redkale.net.http.BasedHttpServlet, 比较好的习惯是一个项目先定义一个项目级的BaseServlet类，这样方便以后加入类似javax.servlet.Filter的功能。

        一个典型的BaseSerlvet实现: 

public class BaseSerlvet extends org.redkale.net.http.BasedHttpServlet {
@@ -49,20 +49,20 @@
 
     protected final boolean fine = logger.isLoggable(Level.FINE);
 
-    @Resource //[RedKale内置资源]  进程的启动时间
+    @Resource //[Redkale内置资源]  进程的启动时间
     protected long serverCreateTime;
 
-    @Resource //[RedKale内置资源]
+    @Resource //[Redkale内置资源]
     protected JsonConvert jsonConvert;
 
-    @Resource //[RedKale内置资源]
+    @Resource //[Redkale内置资源]
     protected JsonFactory jsonFactory;
 
-    //[RedKale内置资源], 当前进程的根目录，字段类型可以是 String、java.io.File、java.nio.file.Path
+    //[Redkale内置资源], 当前进程的根目录，字段类型可以是 String、java.io.File、java.nio.file.Path
     @Resource(name = "APP_HOME")
     protected File home;
 
-    //[RedKale内置资源], 当前Http Server的web页面的根目录，字段类型可以是 String、java.io.File、java.nio.file.Path
+    //[Redkale内置资源], 当前Http Server的web页面的根目录，字段类型可以是 String、java.io.File、java.nio.file.Path
     @Resource(name = "SERVER_ROOT")
     protected File webroot;
 
@@ -73,10 +73,10 @@
     //该方法可以用于判断请求源是否合法或加入一些全局的拦截操作
     @Override
     public boolean preExecute(final HttpRequest request, final HttpResponse response) throws IOException {
-        if (!request.getHeader("User-Agent", "").contains("RedKale-Agent")) {  //只用移动APP的接口可以判断User-Agent是否正确
+        if (!request.getHeader("User-Agent", "").contains("Redkale-Agent")) {  //只用移动APP的接口可以判断User-Agent是否正确
             response.addHeader("retcode", "10001");
             response.addHeader("retmessage", "User-Agent error");
-            response.finish(201, "{'success':false, 'message':'User-Agent error, must be RedKale-Agent'}");
+            response.finish(201, "{'success':false, 'message':'User-Agent error, must be Redkale-Agent'}");
             return false;
         }
         //可以加上一些统计操作
@@ -188,7 +188,7 @@
             
@WebServlet("/ws/chat")
 public class ChatWebSocketServlet extends WebSocketServlet {
 
-    @Resource //[RedKale内置资源]
+    @Resource //[Redkale内置资源]
     protected JsonConvert jsonConvert;
 
     @Resource
@@ -217,7 +217,7 @@
                 final ChatMessage message = jsonConvert.convertFrom(ChatMessage.class, text); //获取给对方的消息体信息
                 message.sendid = user.getUserid(); //将当前用户设为消息的发送方
                 message.sendtime = System.currentTimeMillis(); //设置消息发送时间
-                //给接收方发送消息, 即使接收方在其他WebSocket进程节点上有链接，RedKale也会自动发送到其他链接进程节点上。
+                //给接收方发送消息, 即使接收方在其他WebSocket进程节点上有链接，Redkale也会自动发送到其他链接进程节点上。
                 super.sendEachMessage(message.receiveid, jsonConvert.convertTo(message));
             }
 
@@ -643,7 +643,7 @@
 
             
SNCP 协议

             

-                        SNCP(Service Node Communicate Protocol)协议是RedKale独有的一种传输协议，用于进程之间的通信，即请求方的远程模式Service与响应方的Service之间的通信。可以看成是RMI(远程接口调用)的同款，主要区别在于RedKale里SNCP几乎是透明的，写一个普通的Service通过配置即可实现远程调用，而不需要专门针对远程写接口。SNCP服务的配置与HTTP差不多，只是SNCP不需要Servlet，SncpServlet是通过Service动态生成的。

+                        SNCP(Service Node Communicate Protocol)协议是Redkale独有的一种传输协议，用于进程之间的通信，即请求方的远程模式Service与响应方的Service之间的通信。可以看成是RMI(远程接口调用)的同款，主要区别在于Redkale里SNCP几乎是透明的，写一个普通的Service通过配置即可实现远程调用，而不需要专门针对远程写接口。SNCP服务的配置与HTTP差不多，只是SNCP不需要Servlet，SncpServlet是通过Service动态生成的。

                         SNCP的数据包分包头和包体。包头描述请求的Service信息，请求包的包体描述参数的BSON值，响应包的包体描述回调的参数对象和结果对象的BSON值。

                     包头固定长度为72字节，其结构如下: 
             

@@ -669,11 +669,11 @@
                                 Response : 服务响应对象 

                                 Servlet      : 服务逻辑处理对象 

                                 Server       : 服务监听对象 

-                        通常自定义协议需要继承上面五种对象类，同时为了让RedKale能识别和加载自定义协议服务需要继承 org.redkale.boot.NodeServer 并指明 @NodeProtocol，实现可以参考 基于SOCKS5协议的反向代理服务器
+                        通常自定义协议需要继承上面五种对象类，同时为了让Redkale能识别和加载自定义协议服务需要继承 org.redkale.boot.NodeServer 并指明 @NodeProtocol，实现可以参考 基于SOCKS5协议的反向代理服务器
             

 
             

-                RedKale ©     欢迎加入RedKale技术交流QQ群: 527523235
+                Redkale ©     欢迎加入Redkale技术交流QQ群: 527523235
diff --git a/redkale.html b/redkale.html index 4347aa8f9..54a423288 100644 --- a/redkale.html +++ b/redkale.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -26,9 +26,9 @@
-

RedKale 功能

+

Redkale 功能

-

        RedKale虽然只有1.xM大小，但是麻雀虽小五脏俱全。既可作为服务器使用，也可当工具包使用。作为独立的工具包提供以下功能：
+

        Redkale虽然只有1.xM大小，但是麻雀虽小五脏俱全。既可作为服务器使用，也可当工具包使用。作为独立的工具包提供以下功能：
                1、convert包提供JSON的序列化和反序列化功能，类似Gson、Jackson。
                2、convert包提供Java对象二进制的序列化和反序列化功能，类似Protobuf。
                3、source包提供很简便的数据库操作功能，类似JPA、Hibernate。
@@ -37,8 +37,8 @@                 6、ResourceFactory提供轻量级的依赖注入功能， 类似Google Guice。

-

RedKale 服务器

-

        RedKale作为服务器的目录如下:
+

Redkale 服务器

+

        Redkale作为服务器的目录如下:
                bin   ： 存放启动关闭脚本(start.sh、shutdown.sh、start.bat、shutdown.bat)
                conf ： 存放服务器所需配置文件:
                                     application.xml： 服务配置文件 (必需)；
@@ -49,7 +49,7 @@                 root ： application.xml 配置中HTTP服务所需页面的默认根目录。

-

        RedKale启动的流程如下：
+

        Redkale启动的流程如下：
                1、加载 application.xml 并解析。
                2、初始化 <resources> 节点中的资源。
                3、解析所有的 <server> 节点。
@@ -65,8 +65,8 @@                 6、启动进程本身的监听服务。

-

基于RedKale的开发与调试

-

        基于RedKale创建一个Java应用程序工程(即使是Web项目也不要创建Java-Web工程)，引用redkale.jar 并创建RedKale所需的几个目录和文件。一个普通的Web项目只需要编写业务层的Service和接入层的HttpServlet的代码。数据库DataSource通过配置文件进行设置。
+

基于Redkale的开发与调试

+

        基于Redkale创建一个Java应用程序工程(即使是Web项目也不要创建Java-Web工程)，引用redkale.jar 并创建Redkale所需的几个目录和文件。一个普通的Web项目只需要编写业务层的Service和接入层的HttpServlet的代码。数据库DataSource通过配置文件进行设置。
        编写完代码可以通过启动脚本进行调试， 也可以在IDE设置项目的主类为 org.redkale.boot.Application 或者工程内定义主类进行启动调试: 

public final class Bootstrap {
@@ -83,10 +83,10 @@
         bean.setPassword("123456");
         System.out.println(service.login(bean));
     }
-

        Application.singleton 运行流程与通过bin脚本启动的流程基本一致，区别在于singleton运行时不会启动Server和Application自身的服务监听。RedKale提倡接入层(Servlet)与业务层(Service)分开，Service在代码上不能依赖于Servlet，因此调试Service自身逻辑时不需要启动接入层服务(类似WebSocket依赖Servlet的功能除外)。

+

        Application.singleton 运行流程与通过bin脚本启动的流程基本一致，区别在于singleton运行时不会启动Server和Application自身的服务监听。Redkale提倡接入层(Servlet)与业务层(Service)分开，Service在代码上不能依赖于Servlet，因此调试Service自身逻辑时不需要启动接入层服务(类似WebSocket依赖Servlet的功能除外)。

-

RedKale的依赖注入

-

        RedKale内置的依赖注入实现很简单，只有三个类: javax.annotation.Resource、org.redkale.util.ResourceType、org.redkale.util.ResourceFactory，采用反射技术，由于依赖注入通常不会在频繁的操作中进行，因此性能要求不会很高。其中前两个是注解，ResourceFactory是主要操作类，主要提供注册和注入两个接口。ResourceFactory的依赖注入不仅提供其他依赖注入框架的常规功能，还能动态的自动更新通过inject注入的资源。

+

Redkale的依赖注入

+

        Redkale内置的依赖注入实现很简单，只有三个类: javax.annotation.Resource、org.redkale.util.ResourceType、org.redkale.util.ResourceFactory，采用反射技术，由于依赖注入通常不会在频繁的操作中进行，因此性能要求不会很高。其中前两个是注解，ResourceFactory是主要操作类，主要提供注册和注入两个接口。ResourceFactory的依赖注入不仅提供其他依赖注入框架的常规功能，还能动态的自动更新通过inject注入的资源。

public class AService {
 
     @Resource(name = "property.id")
@@ -167,8 +167,8 @@
 }

        如上例，通过ResourceFactory.inject注入的对象都会自动更新资源的变化，若不想自动更新可以使用public Object register(String name, Type clazz, Object rs) 方法注册新资源。

-

RedKale 架构部署

-

        通常一个系统会分为三层：接入层、业务层、数据层。对应到RedKale的组件是： Servlet、Service、Source。大部分系统提供的是HTTP服务，为了方便演示RedKale从集中式到分布式的变化，以一个简单的HTTP服务作为范例。
+

Redkale 架构部署

+

        通常一个系统会分为三层：接入层、业务层、数据层。对应到Redkale的组件是： Servlet、Service、Source。大部分系统提供的是HTTP服务，为了方便演示Redkale从集中式到分布式的变化，以一个简单的HTTP服务作为范例。
        开发一个极简单的小论坛系统。包含三个模块：
                用户模块    UserSerivice:     提供用户注册、登录、更新资料等功能， UserServlet作为接入层。
                帖子模块 ForumSerivice:     提供看帖、发帖、删帖等功能， ForumServlet作为接入层。
@@ -215,7 +215,7 @@ <!-- SNCP 监听 Server --> <server protocol="SNCP" port="7070"> <services autoload="true" groups="ALL"> - <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且RedKale同时会自动创建一个同名(ws_notify)的 CacheSource --> + <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且Redkale同时会自动创建一个同名(ws_notify)的 CacheSource --> <service name="ws_notify" value="org.redkale.service.WebSocketNodeService"/> <!-- 存在DataSource必须配置DataSourceService --> <service name="demodb" value="org.redkale.service.DataSourceService"/> @@ -249,7 +249,7 @@ <remoteaddr value="request.headers.X-RemoteAddress"/> </request> <services autoload="true" groups="ALL"> - <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且RedKale同时会自动创建一个同名(ws_notify)的 CacheSource --> + <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且Redkale同时会自动创建一个同名(ws_notify)的 CacheSource --> <service name="ws_notify" value="org.redkale.service.WebSocketNodeService"/> </services> <servlets autoload="true" /> @@ -267,7 +267,7 @@ <!-- SNCP 监听 Server --> <server protocol="SNCP" port="7070"> <services autoload="true" groups="ALL"> - <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且RedKale同时会自动创建一个同名(ws_notify)的 CacheSource --> + <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且Redkale同时会自动创建一个同名(ws_notify)的 CacheSource --> <service name="ws_notify" value="org.redkale.service.WebSocketNodeService"/> <!-- 存在DataSource必须配置DataSourceService --> <service name="demodb" value="org.redkale.service.DataSourceService"/> @@ -312,7 +312,7 @@ <service value="org.redkale.demo.UserService" groups="USER_SERVICE"/> <service value="org.redkale.demo.NotifyService" groups="NOTIFY_SERVICE"/> <service value="org.redkale.demo.ForumService" groups="FORUM_SERVICE"/> - <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且RedKale同时会自动创建一个同名(ws_notify)的 CacheSource --> + <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且Redkale同时会自动创建一个同名(ws_notify)的 CacheSource --> <service name="ws_notify" value="org.redkale.service.WebSocketNodeService" groups="NOTIFY_SERVICE"/> </services> <servlets autoload="true" /> @@ -372,7 +372,7 @@ <services autoload="true"> <service value="org.redkale.demo.UserService" groups="USER_SERVICE"/> <service value="org.redkale.demo.ForumService" groups="FORUM_SERVICE"/> - <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且RedKale同时会自动创建一个同名(ws_notify)的 CacheSource --> + <!-- 有WebSocketServlet的服务必须配置WebSocketNodeService，且Redkale同时会自动创建一个同名(ws_notify)的 CacheSource --> <service name="ws_notify" value="org.redkale.service.WebSocketNodeService" groups="NOTIFY_SERVICE"/> <!-- 存在DataSource必须配置DataSourceService --> <service name="demodb" value="org.redkale.service.DataSourceService" groups="NOTIFY_SERVICE"/> @@ -507,7 +507,7 @@ </server> </application>
-

        由以上几种部署方式的范例可以看出，RedKale提供了非常强大的架构，集中式到微服务架构不需要增加修改一行代码即可随意切换，即使网关式部署也只是新增很少的代码就可切换，且不影响其他服务。真正可以做到敏捷开发，复杂的系统都可如小系统般快速地开发出来。
+

        由以上几种部署方式的范例可以看出，Redkale提供了非常强大的架构，集中式到微服务架构不需要增加修改一行代码即可随意切换，即使网关式部署也只是新增很少的代码就可切换，且不影响其他服务。真正可以做到敏捷开发，复杂的系统都可如小系统般快速地开发出来。
        为了降低接入层与业务层代码的耦合， 可以将Service分接口与实现两个类，接入层只加载接口包、业务层使用实现包。


@@ -690,7 +690,7 @@
- RedKale ©     欢迎加入RedKale技术交流QQ群: 527523235 + Redkale ©     欢迎加入Redkale技术交流QQ群: 527523235
diff --git a/service.html b/service.html index fdf5da48e..126c5e971 100644 --- a/service.html +++ b/service.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -28,11 +28,11 @@

Service 组件介绍

-

         Service 是RedKale最核心的组件，依赖于Convert、SNCP协议、Resource依赖注入。Service主要处理业务逻辑和操作数据层，是微服务架构中的单一原子服务。每一个Service实例分两种模式: 本地模式和远程模式。其模式由 conf/application.xml 文件来配置。使用者在调用过程中通常不需要区分当前Service实例是哪种模式。
+

         Service 是Redkale最核心的组件，依赖于Convert、SNCP协议、Resource依赖注入。Service主要处理业务逻辑和操作数据层，是微服务架构中的单一原子服务。每一个Service实例分两种模式: 本地模式和远程模式。其模式由 conf/application.xml 文件来配置。使用者在调用过程中通常不需要区分当前Service实例是哪种模式。
         为了能确保本地模式与远程模式自由切换，对Service的实现类有一定的约束:
                 1、Service实现类会被继承，不能修饰为 final
                 2、带@MultiRun注解的方法会被重载，不能修饰为 final
-          RedKale进程启动时扫描可加载的Service实现类，根据配置文件配置的模式采用JDK 8内置的ASM技术动态生成相应的Service临时类进行实例化，并注册到ResourceFactory同其他Service、Servlet依赖注入。 +          Redkale进程启动时扫描可加载的Service实现类，根据配置文件配置的模式采用JDK 8内置的ASM技术动态生成相应的Service临时类进行实例化，并注册到ResourceFactory同其他Service、Servlet依赖注入。

Service 本地模式

@@ -303,7 +303,7 @@         如上描述，一个请求处理耗时 180ms，同时占用一个线程的时间也是 180ms。若换成NIO使IO耗时减少，为了方便计算假设IO耗时为0(当然实际情况是不可能的), 那么步骤1、4的耗时忽略不计，线程的占用时间由180ms变成160ms。 假设数据查询接口IO操作本身耗时也是10ms，那么有140ms是用于等待。若采用DataSource异步接口， 则140ms的等待时间可以释放当前线程资源。虽然整个请求的处理时间还是180ms，但是线程的占用时间却只有20ms。可以看出减少耗时多的步骤的等待时间才能事半功倍，大幅度地提高性能。异步接口的主要作用是远程请求在等待过程中释放当前线程资源。大大减少线程数，也减少大量线程之间的切换消耗。

- RedKale ©     欢迎加入RedKale技术交流QQ群: 527523235 + Redkale ©     欢迎加入Redkale技术交流QQ群: 527523235
diff --git a/source.html b/source.html index 37e41731d..f2711d7e7 100644 --- a/source.html +++ b/source.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -45,13 +45,13 @@ 注解类名功能描述 javax.persistence.Cacheable标记Entity类是否需要缓存，与JPA用法一致 javax.persistence.Column标记字段，只使用其name()、insertable()、updatable()属性 - javax.persistence.EntityJPA的Entity类必须标记为@Entity, 而RedKale不强制要求，所以该注解一般无用 + javax.persistence.EntityJPA的Entity类必须标记为@Entity, 而Redkale不强制要求，所以该注解一般无用 javax.persistence.GeneratedValue仅用于标记主键是否为数据库自增长，其内值的两属性废弃 - javax.persistence.GenerationType被@GeneratedValue的属性引用，在RedKale内不被使用到 + javax.persistence.GenerationType被@GeneratedValue的属性引用，在Redkale内不被使用到 javax.persistence.Id标记主键字段，与JPA用法一致 javax.persistence.Table标记表的别名，与JPA用法一致 javax.persistence.Transient标记是否为表对应的字段，与JPA用法一致 - 以下是RedKale自定义的注解 + 以下是Redkale自定义的注解 @VirtualEntity用于非数据库表对应的Entity类，且仅用于开启缓存模式的DataSource @DistributeGenerator标记主键是否采用分布式自增长策略，不能与@GeneratedValue同用 @DistributeTables当多个表的主键唯一性公用时需要该注解 @@ -149,7 +149,7 @@

        如上@FilterGroup 的value 必须是[OR]或者[AND]开头，没有标记@FilterGroup的字段等价于标记了@FilterGroup(value = "[AND]")。[AND]、[OR]后面的字符串为GROUP_NAME，默认的GROUP_NAME为空字符串。如上"[OR]a"可以直接使用"[OR]"，有多个[OR]或者[AND]则需要加上不同的NAME。

CacheSource 入门

-

         CacheSource同Memcached类似，像一个带有过期功能地Map容器，存放key-value数据。常见的使用场景就是存放HTTP的Session信息。RedKale把用户会话信息数据当做业务数据处理，而不是接入层的数据。WebSocket的连接态数据也是用CacheSource存储。key为WebSocket的groupid，value为WebSocket服务端节点的IP地址列表。

+

         CacheSource同Memcached类似，像一个带有过期功能地Map容器，存放key-value数据。常见的使用场景就是存放HTTP的Session信息。Redkale把用户会话信息数据当做业务数据处理，而不是接入层的数据。WebSocket的连接态数据也是用CacheSource存储。key为WebSocket的groupid，value为WebSocket服务端节点的IP地址列表。

public class UserService implements Service {
 
     //用户简单信息缓存
@@ -191,8 +191,8 @@
         <properties>
             <property name="javax.persistence.jdbc.url" value="jdbc:mysql://127.0.0.1:3306/dbuser?characterEncoding=utf8"/>
             <!-- 
-                javax.persistence.jdbc.driver在JPA的值是JDBC驱动，RedKale有所不同，值应该是javax.sql.DataSource的子类。 
-                为了兼容用户习惯，RedKale内置常见JDBC驱动到javax.sql.DataSource的映射关系：
+                javax.persistence.jdbc.driver在JPA的值是JDBC驱动，Redkale有所不同，值应该是javax.sql.DataSource的子类。 
+                为了兼容用户习惯，Redkale内置常见JDBC驱动到javax.sql.DataSource的映射关系：
                                        com.mysql.jdbc.Driver  ——————  com.mysql.jdbc.jdbc2.optional.MysqlConnectionPoolDataSource
                                      org.mariadb.jdbc.Driver  ——————  org.mariadb.jdbc.MySQLDataSource
                              oracle.jdbc.driver.OracleDriver  ——————  oracle.jdbc.pool.OracleConnectionPoolDataSource
@@ -207,7 +207,7 @@
             <property name="javax.persistence.connections.limit" value="32"/>
 	    -->
 	    <!-- 
-		包含的SQL模板，相当于反向LIKE，不同的JDBC驱动的SQL语句不一样，RedKale内置了MySQL、Oracle、Sqlserver的语句
+		包含的SQL模板，相当于反向LIKE，不同的JDBC驱动的SQL语句不一样，Redkale内置了MySQL、Oracle、Sqlserver的语句
             <property name="javax.persistence.contain.sqltemplate" value="LOCATE(${keystr}, ${column}) > 0"/>
             <property name="javax.persistence.notcontain.sqltemplate" value="LOCATE(${keystr}, ${column}) = 0"/>
 	    -->
@@ -227,7 +227,7 @@
 </persistence>
- RedKale ©     欢迎加入RedKale技术交流QQ群: 527523235 + Redkale ©     欢迎加入Redkale技术交流QQ群: 527523235
diff --git a/watch.html b/watch.html index 7260b67fe..cbbf9d498 100644 --- a/watch.html +++ b/watch.html @@ -2,9 +2,9 @@ - RedKale - 全新的Java微服务框架 - - + Redkale - 全新的Java微服务框架 + + @@ -13,9 +13,9 @@
- RedKale + Redkale

- RedKale 入门 + Redkale 入门 Convert 组件 Service 组件 Source 组件 @@ -33,7 +33,7 @@