Merge branch 'master' of http://10.1.235.20:3000/rest/rest-guide.git

ipu-service-demo/doc/pom可选配置.md

@@ -0,0 +1,18 @@
如果需要支持redis注册中心，需要增加依赖：
		<dependency>
			<groupId>org.apache.commons</groupId>
			<artifactId>commons-pool2</artifactId>
			<version>2.2</version>
		</dependency>
		<dependency>
			<groupId>redis.clients</groupId>
			<artifactId>jedis</artifactId>
			<version>2.9.0</version>
		</dependency>
如果需要支持json格式报文(如IData param)作为方法的入参，需要增加依赖：		
		<dependency>
			<groupId>com.alibaba</groupId>
			<artifactId>fastjson</artifactId>
			<version>1.2.7</version>
		</dependency>

ipu-service-demo/doc/服务缓存.md

@@ -0,0 +1,18 @@
dubbo支持服务端查询结果进行缓存，减轻后端负载。支持3类缓存：
lru 基于最近最少使用原则删除多余缓存，保持最热的数据被缓存。缺省1000次。
threadlocal 当前线程缓存，比如一个页面渲染，用到很多 portal，每个 portal 都要去查用户信息，通过线程缓存，可以减少这种多余访问。
jcache 与 JSR107 集成，可以桥接各种缓存实现。
自定义缓存参见官方文档《http://dubbo.apache.org/books/dubbo-dev-book/impls/cache.html》
缓存级别：服务级、方法级。缓存配置在consumer/客户端，
服务级配置：
<dubbo:reference interface="com.foo.BarService" cache="lru" />
方法级配置：
<dubbo:reference interface="com.foo.BarService">
    <dubbo:method name="findBar" cache="lru" />
</dubbo:reference>
一旦起用缓存，dubbo会默认会缓存注册中心的信息文件，默认路径在/$userhome/.dubbo/dubbo-registry-$application_name$ip.cache
如果在1台机器上起了多个相同的服务进行缓存，需要在服务运行时，增加jvm参数设置不同的缓存文件，否则会报错。设置方法为：
-Ddubbo.registry.file=/data/.dubbo/dubbo-registry-$service_name$port.cache

ipu-service-demo/doc/注册配置.md

@@ -0,0 +1,17 @@
dubbo服务注册支持zookeeper、redis、multicast、simple。需要在生产者(provider/服务端)和消费者(consumer/客户端)配置文件中采用相同的注册方式。配置方式类似，
配置语法为：
1)<dubbo:registry protocol="zookeeper/redis/multicast/dubbo" address="ip:port" client="zkclient/curator" username="root" password="1234">
<dubbo:parameter key="unicast"value="false"/>
</dubbo:registry>
2)也可以在address里带上协议类型:
<dubbo:registry address="zookeeper://121.42.183.206:2181?client=curator" />
<dubbo:registry address="redis://121.42.183.206:11111" />
<dubbo:registry address="multicast://224.5.6.7:9999?unicast=false" />
<dubbo:registry address="127.0.0.1:20880" />
建议使用2),便于在命令行替换。
zookeeper还支持cluster，多个地址可以用英文逗号符号分隔.redis支持使用1主多从,但是配置到dubbo里时，provider/服务端应连接主redis，多个consumer/客户端可以分别连到从redis。
还支持自定义注册扩展,参见官方文档《http://dubbo.apache.org/books/dubbo-dev-book/impls/registry.html》

ipu-service-demo/readme.md

@@ -0,0 +1,24 @@
1。dubbo服务注册支持zookeeper、redis、multicast、simple和jvm，本地开发调试可以推荐使用single，服务器部署推荐使用zookeeper。具体说明见doc/《注册配置.md》
2。对于大量重复查询，建议使用服务缓存。具体说明见doc/《服务缓存.md》
3。尽量不要复用用于暴露服务的接口.一个接口有不同实现时,建议分组:
provider/服务端:
<dubbo:service group="feedback" interface="com.xxx.IndexService" />
<dubbo:service group="member" interface="com.xxx.IndexService" />
consumer/客户端:
<dubbo:reference id="feedbackIndexService" group="feedback" interface="com.xxx.IndexService" />
<dubbo:reference id="memberIndexService" group="member" interface="com.xxx.IndexService" />
4。本地做代码调试时,请在consumer/客户端的配置文件里配置合适的超时时间。配置方法：
<dubbo:consumer retries="0" timeout="20000"/>
5。建议通过jvm参数方式设置dubbo服务接口：
-Ddubbo.protocol.port="20880"
6.建议通过jvm参数方式设置dubbo服务ip：
-Ddubbo.protocol.host="10.1.1.1"
7。建议通过jvm参数方式设置dubbo注册方式及地址：
方式2修改：
-Ddubbo.registry.address="multicast://224.5.6.7:9999"
方式1修改：
-Ddubbo.registry.protocol="multicast"
-Ddubbo.registry.address="224.5.6.7:9999"
。。。
方式1、方式2参见doc/《注册配置.md》

ipu-service-demo/src/test/java/com/ai/ipu/service/demo/impl/EchoServiceTest.java

@@ -20,13 +20,13 @@ public class EchoServiceTest extends TestCase{
    /**
     * @author ThinkPad@asiainfo.com
     * @title: testEchoService
     * @desc: 回声测试可用性
     * @desc: 回声测试可用性,回声测试用于检测服务是否可用,用于监控
     */
    public void testEchoService() {
        // TODO Auto-generated method stub
        EchoService echoService = (EchoService)context.getBean("demoService"); 
        EchoService echoService = (EchoService)context.getBean("bizService"); 
        Object status = echoService.$echo("OK");
        System.out.println("demoService的服务状态:" + status);
        System.out.println("bizService的服务状态:" + status);
        assert(status.equals("OK"));
    }
}

ipu-service-demo/src/test/resources/dubbo-consumer-simple.xml

@@ -30,9 +30,9 @@
	<!-- 服务拦截 -->
	<bean id="serviceInterceptor" class="com.ai.ipu.service.demo.interceptor.ServiceInterceptor" />
	<dubbo:reference id="bizInterceptService" interface="com.ai.ipu.service.demo.IBizService">
		<dubbo:method name="queryUserInfo" oninvoke="serviceInterceptor.onInvoke"
		<dubbo:method name="queryUserInfo" 
			onreturn="serviceInterceptor.onReturn" />
		<dubbo:method name="triggerException" oninvoke="serviceInterceptor.onInvoke"
		<dubbo:method name="triggerException" 
			onthrow="serviceInterceptor.onThrow" async="true" />
	</dubbo:reference>
	<!-- 服务存根 -->