root
/
spring-framework
mirror of https://github.com/spring-projects/spring-framework.git
1
0
Fork 0
Code Issues Actions 6 Packages Projects Releases Wiki Activity

getAcceptLanguageAsLocale(s) returns most preferred Locale 

An update on the last commit switching from:
List<Locale> getAcceptLanguageAsLocales() to
Locale getAcceptLanguageAsLocale()

This best supports the scenario for the most preferred Locale.
If there is a need to look at the prioritized list of languages it's
best to use Locale.filter with the LocaleRange's.

This is explained in the Javadoc for getAcceptLanguage().

Issue: SPR-15024
This commit is contained in:
Rossen Stoyanchev 2016-12-16 17:15:43 -05:00
parent fa56361ad2
commit bd8af55bc7
2 changed files with 15 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

22
spring-web/src/main/java/org/springframework/http/HttpHeaders.java
View File

@ -440,8 +440,8 @@ public class HttpHeaders implements MultiValueMap<String, String>, Serializable
}
/**
* Set the acceptable language ranges,
* as specified by the {@literal Accept-Language} header.
* Set the acceptable language ranges, as specified by the
* {@literal Accept-Language} header.
* @see Locale.LanguageRange
* @since 5.0
*/
@ -458,8 +458,12 @@ public class HttpHeaders implements MultiValueMap<String, String>, Serializable
}
/**
* Return the acceptable language ranges,
* as specified by the {@literal Accept-Language} header
* Return the acceptable language ranges from the
* {@literal Accept-Language} header
* <p>If you only need the most preferred locale use
* {@link #getAcceptLanguageAsLocale()} or if you need to filter based on
* a list of supporeted locales you can pass the returned list to
* {@link Locale#filter(List, Collection)}.
* @see Locale.LanguageRange
* @since 5.0
*/
@ -473,18 +477,20 @@ public class HttpHeaders implements MultiValueMap<String, String>, Serializable
/**
* A variant of {@link #getAcceptLanguage()} that converts each
* {@link java.util.Locale.LanguageRange} to a {@link Locale}.
* {@link java.util.Locale.LanguageRange} to a {@link Locale} and returns
* the first one on the list.
* @since 5.0
*/
public List<Locale> getAcceptLanguageAsLocales() {
public Locale getAcceptLanguageAsLocale() {
List<Locale.LanguageRange> ranges = getAcceptLanguage();
if (ranges.isEmpty()) {
return Collections.emptyList();
return null;
}
return ranges.stream()
.map(range -> Locale.forLanguageTag(range.getRange()))
.filter(locale -> StringUtils.hasText(locale.getDisplayName()))
.collect(Collectors.toList());
.findFirst()
.orElse(null);
}
/**

8
spring-web/src/test/java/org/springframework/http/HttpHeadersTests.java
View File

@ -437,13 +437,7 @@ public class HttpHeadersTests {
);
assertEquals(expectedRanges, headers.getAcceptLanguage());
List<Locale> expectedLocales = Arrays.asList(
Locale.forLanguageTag("fr-ch"),
Locale.forLanguageTag("fr"),
Locale.forLanguageTag("en"),
Locale.forLanguageTag("de")
);
assertEquals(expectedLocales, headers.getAcceptLanguageAsLocales());
assertEquals(Locale.forLanguageTag("fr-ch"), headers.getAcceptLanguageAsLocale());
}
@Test