仅支持有限数量的语言

Question

我的 API 使用 Jersey 2，现在我想支持国际化。我知道我的客户应该指定 Accept-Language 参数，但我想了解如何正确处理它。

假设我的 API 应该只处理 FRENCH 和 ENGLISH 语言。我知道我可以使用以下代码检索 preferred 语言环境：

@GET
@Path("a-path")
public Response doSomething(@Context HttpServletRequest request) {
    Locale locale = request.getLocale();
    // ...
}

问题是我的 API 不支持首选语言环境。假设我的客户发给我 Accept-Language: da, en-gb;q=0.8, en;q=0.7，根据 w3c，它基本上意味着："I prefer Danish, but will accept British English and other types of English."。由于 preferred 语言环境只是 return 最期望的语言环境，有没有办法让我的 API select 成为第一个支持的语言？我想在一个地方处理它（即在 Filters 中）而不是在每个资源中。

Answer 1

获取语言环境的一种方法是使用 HttpHeaders#getAcceptableLanguages()。

Get a list of languages that are acceptable for the response.

If no acceptable languages are specified, a read-only list containing a single wildcard Locale instance (with language field set to "*") is returned.

Returns: a read-only list of acceptable languages sorted according to their q-value, with highest preference first.

您几乎可以在任何地方注入 HttpHeaders，使用 @Context

public Response doSomething(@Context HttpHeaders headers) {
    List<Locale> langs = headers.getAcceptableLanguages();

如果你想在 filter, you can also get the list list of locales from the ContainerRequestContext

中获取列表

@Override
public void filter(ContainerRequestContext requestContext) throw .. {
    List<Locales> langs = requestContext.getAcceptableLanguages();
}

如果你想在资源方法中使用 Locale，但不想在方法中做所有的语言环境“解析”，你可以使用一些依赖注入，并创建一个 Factory，你可以在其中注入他 HttpHeaders 并在那里解析语言环境

另请参阅： Dependency injection with Jersey 2.0

下面是一个完整的测试用例示例，它结合了我提到的关于在 Factory 中使用过滤器和依赖项注入的最后两点，这样您就可以将已解析的 Locale 注入资源方法。该示例使用仅允许英语的虚拟语言环境解析器。解析语言环境后，我们将其设置到请求上下文属性中，并从 Factory 内部检索，以便我们可以将其注入资源方法

@GET
public String get(@Context Locale locale) {
   return locale.toString();
}

另请参阅： How to inject an object into jersey request context?

如果您还想让我解释一下这个例子，请告诉我

import java.io.IOException;
import java.util.List;
import java.util.Locale;
import java.util.logging.Logger;
import javax.inject.Inject;
import javax.inject.Singleton;
import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.container.ContainerRequestContext;
import javax.ws.rs.container.ContainerRequestFilter;
import javax.ws.rs.container.PreMatching;
import javax.ws.rs.core.Context;
import javax.ws.rs.core.Response;
import javax.ws.rs.ext.Provider;

import org.glassfish.hk2.api.Factory;
import org.glassfish.hk2.utilities.binding.AbstractBinder;
import org.glassfish.jersey.filter.LoggingFilter;
import org.glassfish.jersey.process.internal.RequestScoped;
import org.glassfish.jersey.server.ResourceConfig;
import org.glassfish.jersey.test.JerseyTest;
import org.junit.Test;

import static org.hamcrest.CoreMatchers.is;
import static org.junit.Assert.assertThat;

/**
 * Stack Overflow question 
 * 
 * Run this like any other JUnit test. Only one required test dependency:
 * 
 *  <dependency>
 *      <groupId>org.glassfish.jersey.test-framework.providers</groupId>
 *      <artifactId>jersey-test-framework-provider-inmemory</artifactId>
 *      <version>${jersey2.version}</version>
 *  </dependency>
 *
 * @author Paul Samsotha
 */
public class AcceptLanguageTest extends JerseyTest {
    
    @Path("language")
    public static class TestResource {
       
        @GET
        public String get(@Context Locale locale) {
           return locale.toString();
        }
    }
    
    public static interface LocaleResolver {
        Locale resolveLocale(List<Locale> locales);
    }
    
    // Note: if you look in the javadoc for getAcceptableLanguages()
    // you will notice that it says if there is not acceptable language
    // specified, that there is a default single wildcard (*) locale.
    // So this implementation sucks, as it doesn't check for that.
    // You will want to make sure to do so!
    public static class DefaultLocaleResolver implements LocaleResolver {
        
        @Override
        public Locale resolveLocale(List<Locale> locales) {
            if (locales.contains(Locale.ENGLISH)) {
                return Locale.ENGLISH;
            }
            return null;
        }
    }
    
    @Provider
    @PreMatching
    public static class LocaleResolverFilter implements ContainerRequestFilter {
        
        static final String LOCALE_PROPERTY = "LocaleResolverFilter.localProperty";
        
        @Inject
        private LocaleResolver localeResolver;
        
        @Override
        public void filter(ContainerRequestContext context) throws IOException {
            List<Locale> locales = context.getAcceptableLanguages();
            Locale locale = localeResolver.resolveLocale(locales);
            if (locale == null) {
                context.abortWith(Response.status(Response.Status.NOT_ACCEPTABLE).build());
                return;
            }
            context.setProperty(LOCALE_PROPERTY, locale);
        }
    }
    
    public static class LocaleFactory implements Factory<Locale> {
        
        @Context
        private ContainerRequestContext context;

        @Override
        public Locale provide() {
            return (Locale) context.getProperty(LocaleResolverFilter.LOCALE_PROPERTY);
        }

        @Override
        public void dispose(Locale l) {} 
    }
    
    @Override
    public ResourceConfig configure() {
        return new ResourceConfig(TestResource.class)
                .register(LocaleResolverFilter.class)
                .register(new AbstractBinder() {
                    @Override
                    protected void configure() {
                        bindFactory(LocaleFactory.class)
                                .to(Locale.class).in(RequestScoped.class);
                        bind(DefaultLocaleResolver.class)
                                .to(LocaleResolver.class).in(Singleton.class);
                    }
                })
                .register(new LoggingFilter(Logger.getAnonymousLogger(), true));
    }
    
    @Test
    public void shouldReturnEnglish() {
        final String accept = "da, en-gb;q=0.8, en;q=0.7";
        final Response response = target("language").request()
                .acceptLanguage(accept)
                .get();
        assertThat(response.readEntity(String.class), is("en"));
    }
    
    @Test
    public void shouldReturnNotAcceptable() {
        final String accept = "da";
        final Response response = target("language").request()
                .acceptLanguage(accept)
                .get();
        assertThat(response.getStatus(), is(Response.Status.NOT_ACCEPTABLE.getStatusCode()));
    }
}

Answer 2

JAX-RS API 允许您使用 Request.selectVariant(List) 方法 select 语言环境。

在 REST 处理程序或 CDI bean 中尝试以下代码：

import javax.ws.rs.core.Variant;
import javax.ws.rs.core.Request;

    @Context
    private Request req;

    private Locale getResponseLocale(boolean throwIfNoneMatch) throws NotAcceptableException{
        // Put your supported languages here
        List<Variant> langVariants = Variant.languages(
                new Locale("da"), 
                new Locale("en-gb"), 
                Locale.getDefault()).build();

        Locale locale = Locale.getDefault();
        Variant selectVariant = this.req.selectVariant(langVariants);
        if (selectVariant != null) {
            locale = selectVariant.getLanguage();
        } else if (throwIfNoneMatch) {
            throw new NotAcceptableException(Response.notAcceptable(langVariants).build());
        }

        return locale;
    }

另见 The Java EE Tutorial : Runtime Content Negotiation。

仅支持有限数量的语言

Support only a limited number of languages

java

jersey

servlet-filters

http-accept-language

jersey-2.0