Spring ServiceLocator 介绍及应用 | 隔叶黄莺 Yanbin Blog

2019-04-02 | 阅读(1,674)

在 Spring 中应用 ServiceLocator 方式来获取 Spring Bean 的介绍参考了那么多，其实还是数官方的 ServiceLocatorFactoryBean JavaDoc 文档最言简意该了。Spring 的 ServiceLocator 仿佛用处不大，说到底就是类似于下方找寻某个 Spring Bean 一样：

ApplicationContext context = ...;
Service service = context.getBean(ServiceImpl.class);
Service service = context.getBean("myService");

只是有了 ServiceLocatorFactoryBean(它本质上就是一个 FactoryBean) 后我们不需要直接与 ApplicationContext 打交道，且多个的 Spring Bean 可以从相关的一个 FactoryBean 获得。下面用两个例子来演示(代码中刨去了 package 和 import 部分的代码)

一：实现类只有一个 Spring Bean 时

接口类 Parser(我们要定位就是它的实现类)

public interface Parser {
    <T> T parse(String content);
}

public interface Parser {

<T> T parse(String content);

}

Parser 的一个实现类 JsonParser, 并且用 @Named 注册到了 Spring 上下文

@Named
public class JsonParser implements Parser {

    @Override
    public JsonNode parse(String content) {
        try {
            return new ObjectMapper().readTree(content);
        } catch (IOException e) {
            throw new UncheckedIOException(e);
        }
    }
}

@Named

public class JsonParser implements Parser {

@Override

public JsonNode parse(String content) {

try {

return new ObjectMapper().readTree(content);

} catch (IOException e) {

throw new UncheckedIOException(e);

}

用于查找 Parser 实现的接口(我们无需为它提供实现)

public interface ParserFactory {
   Parser getParser();
}

public interface ParserFactory {

Parser getParser();

}

声明用于查找 Parser 实现的 FactoryBean(即 ServiceLocatorFactoryBean)

@Configuration
public class AppConfig {

    @Bean
    public FactoryBean parserFactory() {
        ServiceLocatorFactoryBean factoryBean = new ServiceLocatorFactoryBean();
        factoryBean.setServiceLocatorInterface(ParserFactory.class); //指定的是 ParserFactory 接口
        return factoryBean;
    }
}

@Configuration

public class AppConfig {

@Bean

public FactoryBean parserFactory() {

ServiceLocatorFactoryBean factoryBean = new ServiceLocatorFactoryBean();

factoryBean.setServiceLocatorInterface(ParserFactory.class); //指定的是 ParserFactory 接口

return factoryBean;

}

最后是应用 ServiceLocatorFacoryBean 的客户端代码

@SpringBootApplication
public class Client implements CommandLineRunner {

    @Inject
    private ParserFactory parserFactory;

    public static void main(String[] args) {
        SpringApplication.run(Client.class, args);
    }

    @Override
    public void run(String... args) throws Exception {
        Parser parser = parserFactory.getParser();  //通过 ParserFactory 的 getParser() 定位到相应类型的 Parser 实例
        JsonNode json = parser.parse("{\"gretting\": \"Hello World!\"}");
        System.out.println(json.at("/gretting").asText());
    }
}

@SpringBootApplication

public class Client implements CommandLineRunner {

@Inject

private ParserFactory parserFactory;

public static void main(String[] args) {

SpringApplication.run(Client.class, args);

}

@Override

public void run(String... args) throws Exception {

Parser parser = parserFactory.getParser(); //通过 ParserFactory 的 getParser() 定位到相应类型的 Parser 实例

JsonNode json = parser.parse("{\"gretting\": \"Hello World!\"}");

System.out.println(json.at("/gretting").asText());

}

执行上面的代码，输出为解析后 JSON 的 gretting 值

Hello World!

上面发生了什么

进到 ServiceLocatorFactoryBean 的内部类 ServiceLocatorInvocationHandler, 关键代码如下：

private class ServiceLocatorInvocationHandler implements InvocationHandler {

    private Object invokeServiceLocatorMethod(Method method, Object[] args) throws Exception {
        Class<?> serviceLocatorMethodReturnType = getServiceLocatorMethodReturnType(method);
        try {
            String beanName = tryGetBeanName(args);
            if (StringUtils.hasLength(beanName)) {
                // Service locator for a specific bean name
                return beanFactory.getBean(beanName, serviceLocatorMethodReturnType);
            }
            else {
                // Service locator for a bean type
                return beanFactory.getBean(serviceLocatorMethodReturnType);
            }
        }
        catch (BeansException ex) {
            ......
        }
    }

private class ServiceLocatorInvocationHandler implements InvocationHandler {

private Object invokeServiceLocatorMethod(Method method, Object[] args) throws Exception {

Class<?> serviceLocatorMethodReturnType = getServiceLocatorMethodReturnType(method);

try {

String beanName = tryGetBeanName(args);

if (StringUtils.hasLength(beanName)) {

// Service locator for a specific bean name

return beanFactory.getBean(beanName, serviceLocatorMethodReturnType);

}

else {

// Service locator for a bean type

return beanFactory.getBean(serviceLocatorMethodReturnType);

}

catch (BeansException ex) {

......

}

ParserFactory.getParser() 不带参数的方式会找到一个指定相应类型的 Bean，如果 Spring 上下文中注册了两个 Parser 将会出错
ParserFactory.getParser(beanName) 如果是带了参数，将以此参数作为 Spring Bean 的名称去 Spring 上下文中查找

现在可以测试一下第一种情况有多个 Parser 实现时的异常，再加一个 Parser 的 XML 实现 XmlParser

@Named
public class XmlParser implements Parser {

    @Override
    public Document parse(String content) {
        DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();

        try {
            DocumentBuilder builder = factory.newDocumentBuilder();
            return builder.parse(new InputSource(new StringReader(content)));
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }
}

@Named

public class XmlParser implements Parser {

@Override

public Document parse(String content) {

DocumentBuilderFactory factory = DocumentBuilderFactory.newInstance();

try {

DocumentBuilder builder = factory.newDocumentBuilder();

return builder.parse(new InputSource(new StringReader(content)));

} catch (Exception e) {

throw new RuntimeException(e);

}

运行之前相同的 Client 代码，Spring 应用无法启动，异常是

Caused by: org.springframework.beans.factory.NoUniqueBeanDefinitionException: No qualifying bean of type 'yanbin.blog.Parser' available: expected single matching bean but found 2: jsonParser,xmlParser
at org.springframework.beans.factory.support.DefaultListableBeanFactory.resolveNamedBean(DefaultListableBeanFactory.java:1039)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBean(DefaultListableBeanFactory.java:344)
at org.springframework.beans.factory.support.DefaultListableBeanFactory.getBean(DefaultListableBeanFactory.java:339)
at org.springframework.beans.factory.config.ServiceLocatorFactoryBean$ServiceLocatorInvocationHandler.invokeServiceLocatorMethod(ServiceLocatorFactoryBean.java:377)
at org.springframework.beans.factory.config.ServiceLocatorFactoryBean$ServiceLocatorInvocationHandler.invoke(ServiceLocatorFactoryBean.java:363)
at com.sun.proxy.$Proxy35.getParser(Unknown Source)
at yanbin.blog.Client.run(Client.java:22)

原因是找到两个 Parser 实现 jsonParser 和 xmlParser, 不知道该注入哪一个，所以报错。这时候就要用带参数的 ServiceLocator 方式，即

二：实现类有多个 Spring Bean 时

多个实现类时就必须用 Bean Name 来区分了，在有了前面的 Parser 的两个实现 jsonParser 和 xmlParser 时，ParserFactory 相应的方法要带上一个 Bean Name 参数了

新的 ParserFactory 类代码变为

public interface ParserFactory {
   Parser getParser(String beanName);
}

public interface ParserFactory {

Parser getParser(String beanName);

}

Client 类中相关应用代码现在是

@SpringBootApplication
public class Client implements CommandLineRunner {

    @Inject
    private ParserFactory parserFactory;

    @Override
    public void run(String... args) throws Exception {
        Parser xmlParser = parserFactory.getParser("xmlParser");
        Document doc = xmlParser.parse("<greeting>Hello World!</greeting>");
        System.out.println(xmlParser.getClass().getSimpleName() + ": " + doc.getElementsByTagName("greeting").item(0).getTextContent());

        Parser jsonParser = parserFactory.getParser("jsonParser");
        JsonNode json = jsonParser.parse("{\"gretting\": \"Hello World!\"}");
        System.out.println(jsonParser.getClass().getSimpleName() + ": " + json.at("/gretting").asText());
    }
}

@SpringBootApplication

public class Client implements CommandLineRunner {

@Inject

private ParserFactory parserFactory;

@Override

public void run(String... args) throws Exception {

Parser xmlParser = parserFactory.getParser("xmlParser");

Document doc = xmlParser.parse("<greeting>Hello World!</greeting>");

System.out.println(xmlParser.getClass().getSimpleName() + ": " + doc.getElementsByTagName("greeting").item(0).getTextContent());

Parser jsonParser = parserFactory.getParser("jsonParser");

JsonNode json = jsonParser.parse("{\"gretting\": \"Hello World!\"}");

System.out.println(jsonParser.getClass().getSimpleName() + ": " + json.at("/gretting").asText());

}

执行后输出如下：

XmlParser: Hello World!
JsonParser: Hello World!

Spring Bean name 映射

默认时带参数的定位方法(如 parserFactory.getParser(beanName) 的参数是 Spring Bean 的名称，我们也可以在声明 ServiceLocatorFactoryBean 时自定义名称映射关系。比如在前面的 AppConfig 中 parserFactory() 方法中为 factoryBean 调用 setServiceMappings() 方法

    Properties properties = new Properties();
    properties.setProperty("j", "jsonParser");
    properties.setProperty("x", "xmlParser");
    factoryBean.setServiceMappings(properties);

Properties properties = new Properties();

properties.setProperty("j", "jsonParser");

properties.setProperty("x", "xmlParser");

factoryBean.setServiceMappings(properties);

那么在获取 jsonParser 或 xmlParser 实例时可以分别用 "j" 和 "x" 来获得

    Parser xmlParser = parserFactory.getParser("x");
    Parser jsonParser = parserFactory.getParser("j");

1 2	Parser xmlParser = parserFactory.getParser("x"); Parser jsonParser = parserFactory.getParser("j");

这样体验下来 ServiceLocatorFactoryBean 意义真的不是那么的大。如果我们在通过注入或实现 ApplicationContextAware 接口后获得了 ApplicationContext(BeanFactory) 后，就可直接调用 BeanFactory 的各个 getBean(...) 方法来得到任意想要的 Spring Bean。唯一能想到的好处就是前面提到过的，用于把类似的 Spring Bean 组织到一起来，由一个 ServiceLocator 来提供。

本文链接 https://yanbin.blog/spring-servicelocator-pattern/, 来自隔叶黄莺 Yanbin Blog

seetimee on 体验 Python FastAPI 的并发能力及线, 进程模型感谢
Yanbin on Mockito 3.4.0 开始可 Mock 静态方法有一个补救，新写了一篇 https://yanbin.blog/mockito-mock-static-method-in-multiple...
Yanbin on 升级到 Spring Boot 3 后 javax.inject.Named 不可用怎么，被抄袭了！算是被机器翻译引用的？
oleksi on 升级到 Spring Boot 3 后 javax.inject.Named 不可用https://www.springcloud.io/post/2023-02/springboot-3-javax-inject-name...
Zhe on 体验 Python FastAPI 的并发能力及线, 进程模型你在trio下得用 trio.sleep()，调用asyncio.sleep() 就会报错。

M	T	W	T	F	S	S
				1	2	3
4	5	6	7	8	9	10
11	12	13	14	15	16	17
18	19	20	21	22	23	24
25	26	27	28	29	30