SpringCloud（第 007 篇）電影微服務哥谷，使用定制化 Ribbon 在客戶端進行負載均衡呼巷，使用 RibbonClient 不同服務不同配置策略
一王悍、大致介紹
1压储、通過 RibbonClient 注解來設置隨機調(diào)度算法方式集惋；
2、通過 restTemplate.getForObject刮刑、loadBalancerClient.choose 兩種代碼調(diào)用方式來測試客戶端負載均衡算法喉祭；
二、實現(xiàn)步驟
2.1 添加 maven 引用包
<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<artifactId>springms-consumer-movie-ribbon-custom</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>jar</packaging>
<parent>
<groupId>com.springms.cloud</groupId>
<artifactId>springms-spring-cloud</artifactId>
<version>1.0-SNAPSHOT</version>
</parent>
<dependencies>
<!-- web模塊 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-web</artifactId>
</dependency>
<!-- 客戶端發(fā)現(xiàn)模塊 -->
<dependency>
<groupId>org.springframework.cloud</groupId>
<artifactId>spring-cloud-starter-eureka</artifactId>
</dependency>
<!-- 監(jiān)控和管理生產(chǎn)環(huán)境的模塊 -->
<dependency>
<groupId>org.springframework.boot</groupId>
<artifactId>spring-boot-starter-actuator</artifactId>
</dependency>
</dependencies>
</project>
2.2 添加應用配置文件（springms-consumer-movie-ribbon-custom\src\main\resources\application.yml）
spring:
application:
name: springms-consumer-movie-ribbon-custom
server:
port: 8020
#做負載均衡的時候雷绢，不需要這個動態(tài)配置的地址
#user:
# userServicePath: http://localhost:7900/simple/
eureka:
client:
# healthcheck:
# enabled: true
serviceUrl:
defaultZone: http://admin:admin@localhost:8761/eureka
instance:
prefer-ip-address: true
instance-id: ${spring.application.name}:${spring.cloud.client.ipAddress}:${spring.application.instance_id:${server.port}}
2.3 添加實體用戶類User（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\entity\User.java）
package com.springms.cloud.entity;
import java.math.BigDecimal;
public class User {
private Long id;
private String username;
private String name;
private Short age;
private BigDecimal balance;
public Long getId() {
return this.id;
}
public void setId(Long id) {
this.id = id;
}
public String getUsername() {
return this.username;
}
public void setUsername(String username) {
this.username = username;
}
public String getName() {
return this.name;
}
public void setName(String name) {
this.name = name;
}
public Short getAge() {
return this.age;
}
public void setAge(Short age) {
this.age = age;
}
public BigDecimal getBalance() {
return this.balance;
}
public void setBalance(BigDecimal balance) {
this.balance = balance;
}
}
2.4 添加 RibbonClient 配置類01（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\config\TestConfigurationInside2ScanPackage.java）
package com.springms.cloud.config;
import com.netflix.loadbalancer.RoundRobinRule;
import com.springms.cloud.ExcludeFromComponentScan;
import com.netflix.loadbalancer.IRule;
import com.netflix.loadbalancer.RandomRule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 測試定制 Ribbon ,而且該定制的配置文件是在應用掃描的目錄里面泛烙，也就是說應用啟動后該文件會被掃描到翘紊。
*
* RibbonClient 中的 name 名稱蔽氨，一定要是 eureka 服務中注冊的名稱。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 2017/9/17
*
*/
@Configuration
@ExcludeFromComponentScan
public class TestConfigurationInside2ScanPackage {
/**
* 采用隨機分配的策略帆疟。
*
* @return
*/
@Bean
public IRule ribbonRule(){
return new RandomRule();
//return new RoundRobinRule();
}
}
2.5 添加 RibbonClient 配置類02（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\config\TestConfigurationOutsideScanPackage.java）
package com.springms.config;
import com.netflix.loadbalancer.IRule;
import com.netflix.loadbalancer.RandomRule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 測試定制 Ribbon ,而且該定制的配置文件是不在應用掃描的目錄里面鹉究，也就是說應用啟動后該文件不會被掃描到。
*
* RibbonClient 中的 name 名稱踪宠，一定要是 eureka 服務中注冊的名稱自赔。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 2017/9/17
*
*/
@Configuration
public class TestConfigurationOutsideScanPackage {
// @Autowired
// IClientConfig config;
//
// /**
// *
// * 添加這個 Bean 的注解，主要是因為定義 config 的時候報錯殴蓬，也就是說明 config 沒有被實例化匿级。
// *
// */
// @Bean
// public IClientConfig config(){
// return new DefaultClientConfigImpl();
// }
/**
* 采用隨機分配的策略蟋滴。
*
* @return
*/
@Bean
public IRule ribbonRule(){
return new RandomRule();
}
}
2.6 添加 RibbonClient 配置類03（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\TestConfigurationInsideScanPackage.java）
package com.springms.cloud;
import com.netflix.loadbalancer.IRule;
import com.netflix.loadbalancer.RandomRule;
import com.netflix.loadbalancer.RoundRobinRule;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
/**
* 測試定制 Ribbon ,而且該定制的配置文件是在應用掃描的目錄里面，也就是說應用啟動后該文件會被掃描到痘绎。
*
* RibbonClient 中的 name 名稱津函，一定要是 eureka 服務中注冊的名稱。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 2017/9/17
*
*/
@Configuration
@ExcludeFromComponentScan
public class TestConfigurationInsideScanPackage {
/**
* 采用隨機分配的策略孤页。
*
* @return
*/
@Bean
public IRule ribbonRule(){
// return new RoundRobinRule();
return new RandomRule();
}
}
2.7 添加注解尔苦，目的就是讓應用啟動后，含有該注解的文件不會被應用掃描到（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\ExcludeFromComponentScan.java）
package com.springms.cloud;
/**
* 添加該注解行施，目的就是讓應用啟動后允坚，含有該注解的文件不會被應用掃描到。
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 2017/9/17
*
*/
public @interface ExcludeFromComponentScan {
}
2.8 添加Web訪問層Controller（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\controller\MovieCustomRibbonController.java）
package com.springms.cloud.controller;
import com.springms.cloud.entity.User;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.cloud.client.ServiceInstance;
import org.springframework.cloud.client.loadbalancer.LoadBalancerClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.client.RestTemplate;
@RestController
public class MovieCustomRibbonController {
@Autowired
private RestTemplate restTemplate;
@Autowired
private LoadBalancerClient loadBalancerClient;
@GetMapping("/movie/{id}")
public User findById(@PathVariable Long id) {
// http://localhost:7900/simple/
// VIP：virtual IP
// HAProxy Heartbeat
return this.restTemplate.getForObject("http://springms-provider-user/simple/" + id, User.class);
}
@GetMapping("/choose")
public String test() {
ServiceInstance serviceInstance = this.loadBalancerClient.choose("springms-provider-user");
System.out.println("00000" + ":" + serviceInstance.getServiceId() + ":" + serviceInstance.getHost() + ":" + serviceInstance.getPort());
ServiceInstance serviceInstance2 = this.loadBalancerClient.choose("springms-provider-user2");
System.out.println("222222222222222222" + ":" + serviceInstance2.getServiceId() + ":" + serviceInstance2.getHost() + ":" + serviceInstance2.getPort());
return "choose successful";
}
}
2.9 添加電影微服務啟動類（springms-consumer-movie-ribbon-custom\src\main\java\com\springms\cloud\MsConsumerMovieCustomRibbonApplication.java）
package com.springms.cloud;
import com.springms.cloud.config.TestConfigurationInside2ScanPackage;
import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;
import org.springframework.cloud.client.loadbalancer.LoadBalanced;
import org.springframework.cloud.netflix.eureka.EnableEurekaClient;
import org.springframework.cloud.netflix.ribbon.RibbonClient;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.FilterType;
import org.springframework.web.client.RestTemplate;
/**
* 電影微服務蛾号，使用定制化 Ribbon 在客戶端進行負載均衡稠项，使用 RibbonClient 不同服務不同配置策略。
*
* LoadBalanced：該負載均衡注解鲜结，已經(jīng)整合了 Ribbon展运；
*
* Ribbon 的默認負載均衡的算法為：輪詢；
*
* @author hmilyylimh
*
* @version 0.0.1
*
* @date 2017/9/17
*
*/
@SpringBootApplication
@EnableEurekaClient
@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInsideScanPackage.class)
@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
public class MsConsumerMovieCustomRibbonApplication {
@Bean
@LoadBalanced
public RestTemplate restTemplate(){
return new RestTemplate();
}
public static void main(String[] args) {
SpringApplication.run(MsConsumerMovieCustomRibbonApplication.class, args);
System.out.println("【【【【【【 電影微服務-定制Ribbon 】】】】】】已啟動.");
}
}
三精刷、測試
/****************************************************************************************
一拗胜、電影微服務，使用定制化 Ribbon 在客戶端進行負載均衡怒允，使用 RibbonClient 不同服務不同配置策略（測試輪詢分配服務器地址 TestConfigurationOutsideScanPackage））：
1埂软、使用注解：@SpringBootApplication、@EnableEurekaClient纫事；
2勘畔、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationOutsideScanPackage.class)
3、TestConfigurationInsideScanPackage 類中采用 RoundRobinRule 輪詢調(diào)度算法丽惶；
4咖杂、啟動 springms-provider-user 模塊服務，啟動3個端口（7900蚊夫、7899、7898）懦尝；
5知纷、啟動 springms-consumer-movie-ribbon-custom 模塊服務，啟動1個端口陵霉；
6琅轧、在瀏覽器輸入地址http://localhost:8020/movie/2，然后看看 springms-provider-user 的三個端口的服務打印的信息是否均勻踊挠，正常情況下應該是輪詢打诱Ч稹冲杀；
總結(jié)：客戶端之所以會輪詢調(diào)用各個微服務，是因為在 TestConfigurationOutsideScanPackage 類中配置了負載均衡調(diào)度算法：輪詢 RoundRobinRule 策略算法睹酌；
****************************************************************************************/
/****************************************************************************************
二权谁、電影微服務，使用定制化 Ribbon 在客戶端進行負載均衡憋沿，使用 RibbonClient 不同服務不同配置策略（測試輪詢分配服務器地址 TestConfigurationInsideScanPackage）：
1旺芽、使用注解：@SpringBootApplication、@EnableEurekaClient辐啄；
2采章、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInsideScanPackage.class)
3、使用注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
4壶辜、TestConfigurationInsideScanPackage 類中采用 RoundRobinRule 輪詢調(diào)度算法悯舟；
5、啟動 springms-provider-user 模塊服務砸民，啟動3個端口（7900抵怎、7899、7898）阱洪；
6便贵、啟動 springms-consumer-movie-ribbon-custom 模塊服務，啟動1個端口冗荸；
7承璃、在瀏覽器輸入地址http://localhost:8020/movie/2，然后看看 springms-provider-user 的三個端口的服務打印的信息是否均勻蚌本，正常情況下應該是輪詢打涌狻；
總結(jié)一：客戶端之所以會輪詢分配調(diào)用各個微服務程癌，是因為在注解方面采用了注解 ComponentScan 使配置文件 TestConfigurationOutsideScanPackage 不被掃描到舷嗡，然后再結(jié)合 TestConfigurationOutsideScanPackage 類中配置了負載均衡調(diào)度算法：輪詢 RoundRobinRule 策略算法；
總結(jié)二：可以發(fā)現(xiàn)規(guī)律嵌莉，當使用 “restTemplate.getForObject("http://springms-provider-user/simple/" + id, User.class)” 這種方式負載均衡調(diào)用各個微服務跟配置文件 TestConfigurationOutsideScanPackage 在哪里沒有關(guān)系进萄；
****************************************************************************************/
/****************************************************************************************
三、電影微服務锐峭，使用定制化 Ribbon 在客戶端進行負載均衡中鼠，使用 RibbonClient 不同服務不同配置策略（測試隨機分配服務器地址 TestConfigurationOutsideScanPackage））：
1、使用注解：@SpringBootApplication沿癞、@EnableEurekaClient援雇；
2、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationOutsideScanPackage.class)
3椎扬、TestConfigurationInsideScanPackage 類中采用 RandomRule 隨機調(diào)度算法惫搏；
4具温、啟動 springms-provider-user 模塊服務，啟動3個端口（7900筐赔、7899铣猩、7898）；
5川陆、啟動 springms-consumer-movie-ribbon-custom 模塊服務剂习，啟動1個端口；
6较沪、在瀏覽器輸入地址http://localhost:8020/movie/2鳞绕，然后看看 springms-provider-user 的三個端口的服務打印的信息是否均勻，正常情況下應該是隨機打邮们何；
總結(jié)：客戶端之所以會隨機調(diào)用各個微服務，是因為在 TestConfigurationOutsideScanPackage 類中配置了負載均衡調(diào)度算法：隨機 RandomRule 策略算法控轿；
****************************************************************************************/
/****************************************************************************************
四冤竹、電影微服務，使用定制化 Ribbon 在客戶端進行負載均衡茬射，使用 RibbonClient 不同服務不同配置策略（測試隨機分配服務器地址 TestConfigurationInsideScanPackage）：
1鹦蠕、使用注解：@SpringBootApplication、@EnableEurekaClient在抛；
2钟病、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInsideScanPackage.class)
3、使用注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
4刚梭、TestConfigurationInsideScanPackage 類中采用 RandomRule 隨機調(diào)度算法肠阱；
5、啟動 springms-provider-user 模塊服務朴读，啟動3個端口（7900屹徘、7899、7898）衅金；
6噪伊、啟動 springms-consumer-movie-ribbon-custom 模塊服務，啟動1個端口氮唯；
7酥宴、在瀏覽器輸入地址http://localhost:8020/movie/2，然后看看 springms-provider-user 的三個端口的服務打印的信息是否均勻您觉，正常情況下應該是隨機打印授滓；
總結(jié)一：客戶端之所以會輪詢分配調(diào)用各個微服務琳水，是因為在注解方面采用了注解 ComponentScan 使配置文件 TestConfigurationOutsideScanPackage 不被掃描到肆糕，然后再結(jié)合 TestConfigurationOutsideScanPackage 類中配置了負載均衡調(diào)度算法：隨機 RandomRule 策略算法；
總結(jié)二：可以發(fā)現(xiàn)規(guī)律在孝，當使用 “restTemplate.getForObject("http://springms-provider-user/simple/" + id, User.class)” 這種方式負載均衡調(diào)用各個微服務跟配置文件 TestConfigurationOutsideScanPackage 在哪里沒有關(guān)系诚啃；
總結(jié)三：由（測試一、測試二）和（測試三私沮、測試四）對比可知始赎，當使用 “restTemplate.getForObject("http://springms-provider-user/simple/" + id, User.class)” 這種方式負載均衡調(diào)用各個微服務不需要考慮配置文件的放在哪個包下面。
****************************************************************************************/
/****************************************************************************************
五仔燕、電影微服務造垛，使用定制化 Ribbon 在客戶端進行負載均衡，使用 RibbonClient 不同服務不同配置策略（測試自定義分配服務器地址 TestConfigurationInside2ScanPackage 調(diào)度方式）：
1晰搀、使用注解：@SpringBootApplication五辽、@EnableEurekaClient；
2外恕、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInside2ScanPackage.class)
3杆逗、使用注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
3、TestConfigurationInside2ScanPackage 類中采用 RoundRobinRule 輪詢調(diào)度算法鳞疲；
4罪郊、在 MovieCustomRibbonController 里面添加 test 方法來做測試；
5尚洽、啟動 springms-provider-user 模塊服務悔橄，啟動3個端口（7900、7899翎朱、7898）橄维；
6、啟動 springms-provider-user2 模塊服務拴曲，啟動2個端口（7997争舞、7996）（直接將用戶微服務 spring.application.name 改了個名字為 springms-provider-user2 再啟動而已）；
7澈灼、啟動 springms-consumer-movie-ribbon-custom 模塊服務竞川；
8、在瀏覽器輸入地址http://localhost:8020/choose叁熔，然后看看 springms-provider-user委乌、springms-provider-user2 的各個對應的端口的服務打印的信息是否均勻，正常情況下應該是輪詢分配打印的荣回；
總結(jié)：springms-provider-user（之所以輪詢是因為使用了 RibbonClient 配置采用 RoundRobinRule 輪詢調(diào)度算法）遭贸、springms-provider-user2（之所以輪詢是因為沒有任何配置，默認調(diào)度算法就是輪詢算法）心软；
****************************************************************************************/
/****************************************************************************************
六壕吹、電影微服務著蛙，使用定制化 Ribbon 在客戶端進行負載均衡，使用 RibbonClient 不同服務不同配置策略（測試自定義分配服務器地址 TestConfigurationInside2ScanPackage 調(diào)度方式）：
1耳贬、使用注解：@SpringBootApplication踏堡、@EnableEurekaClient；
2咒劲、使用注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInside2ScanPackage.class)
3顷蟆、使用注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
3、TestConfigurationInside2ScanPackage 類中采用 RandomRule 隨機調(diào)度算法腐魂；
4帐偎、在 MovieCustomRibbonController 里面添加 test 方法來做測試；
5挤渔、啟動 springms-provider-user 模塊服務肮街，啟動3個端口（7900、7899判导、7898）嫉父；
6、啟動 springms-provider-user2 模塊服務眼刃，啟動2個端口（7997绕辖、7996）（直接將用戶微服務 spring.application.name 改了個名字為 springms-provider-user2 再啟動而已）；
7擂红、啟動 springms-consumer-movie-ribbon-custom 模塊服務仪际；
8、在瀏覽器輸入地址http://localhost:8020/choose昵骤，然后看看 springms-provider-user树碱、springms-provider-user2 的各個對應的服務打印的信息是否均勻，正常情況下應該是 springms-provider-user 隨機分配变秦，springms-provider-user2 輪詢分配成榜；
總結(jié)：springms-provider-user（之所以隨機是因為使用了 RibbonClient 配置采用 RandomRule 隨機調(diào)度算法）、springms-provider-user2（之所以輪詢是因為沒有任何配置蹦玫，默認調(diào)度算法就是輪詢算法）赎婚；
****************************************************************************************/
/****************************************************************************************
七、電影微服務樱溉，使用定制化 Ribbon 在客戶端進行負載均衡挣输，使用 RibbonClient 不同服務不同配置策略（測試自定義分配服務器地址 TestConfigurationInsideScanPackage 調(diào)度方式）：
1、注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInsideScanPackage.class)
2福贞、注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
3撩嚼、TestConfigurationInsideScanPackage 類中采用 RoundRobinRule 輪詢調(diào)度算法；
4、在 MovieCustomRibbonController 里面添加 test 方法來做測試绢馍；
5向瓷、啟動 springms-provider-user 模塊服務，啟動3個端口（7900舰涌、7899、7898）你稚；
6瓷耙、啟動 springms-provider-user2 模塊服務，啟動2個端口（7997刁赖、7996）（直接將用戶微服務 spring.application.name 改了個名字為 springms-provider-user2 再啟動而已）搁痛；
7、啟動 springms-consumer-movie-ribbon-custom 模塊服務宇弛；
8鸡典、在瀏覽器輸入地址http://localhost:8020/choose，然后看看 springms-provider-user枪芒、springms-provider-user2 的兩個端口的服務打印的信息是否均勻彻况，正常情況下都是輪詢打印舅踪；
總結(jié)：springms-provider-user（之所以隨機是因為使用了 RibbonClient 配置采用 RoundRobinRule 輪詢調(diào)度算法）纽甘、springms-provider-user2（之所以輪詢是因為沒有任何配置，默認調(diào)度算法就是輪詢算法）抽碌；
****************************************************************************************/
/****************************************************************************************
八悍赢、電影微服務，使用定制化 Ribbon 在客戶端進行負載均衡货徙，使用 RibbonClient 不同服務不同配置策略（測試自定義分配服務器地址 TestConfigurationInsideScanPackage 調(diào)度方式）：
1左权、注解：@RibbonClient(name = "springms-provider-user", configuration = TestConfigurationInsideScanPackage.class)
2、注解：@ComponentScan(excludeFilters = { @ComponentScan.Filter(type = FilterType.ANNOTATION, value = ExcludeFromComponentScan.class) })
3痴颊、TestConfigurationInsideScanPackage 類中采用 RandomRule 隨機調(diào)度算法赏迟；
4、在 MovieCustomRibbonController 里面添加 test 方法來做測試祷舀；
5瀑梗、啟動 springms-provider-user 模塊服務，啟動3個端口（7900裳扯、7899抛丽、7898）；
6饰豺、啟動 springms-provider-user2 模塊服務亿鲜，啟動2個端口（7997、7996）（直接將用戶微服務 spring.application.name 改了個名字為 springms-provider-user2 再啟動而已）；
7蒿柳、啟動 springms-consumer-movie-ribbon-custom 模塊服務饶套；
8垒探、在瀏覽器輸入地址http://localhost:8020/choose妓蛮，然后看看 springms-provider-user、springms-provider-user2 的兩個端口的服務打印的信息是否均勻蛤克，正常情況下應該是 springms-provider-user 隨機分配，springms-provider-user2 輪詢分配；
總結(jié)：springms-provider-user（之所以隨機是因為使用了 RibbonClient 配置采用 RandomRule 隨機調(diào)度算法）、springms-provider-user2（之所以輪詢是因為沒有任何配置凰慈，默認調(diào)度算法就是輪詢算法）；
****************************************************************************************/
