JarCastingSpringMVC-UADetectors
Simple library that can be used to wrap awesome uadetector library into your springmvc project.
Java Configuration
Just add EnableUADetector to be able to inject ReadableUserAgent arguments to your controller methods. This annotation can be configured with following parameters:
| Parameter | Values | Description |
|---|---|---|
cache |
NONE |
Do not use any cache. |
DEFAULT |
Use simple cache provided by springmvc-uadetector (use a concurrent hashmap internally). | |
GUAVA |
Use guava cache (guava must be on classpath). | |
AUTO |
Use guava cache if guava is available or switch to simple cache implementation. This is the default. | |
autowire |
true |
Allow ReadableUserAgent and Browser arguments to be autowired. |
false |
Disable autowiring of ReadableUserAgent and Browser arguments. This is the default. |
Additions
In addition to ReadableUserAgent object, springmvc-uadetector allow you to use a Browser object that contains shortcuts on top of ReadableUserAgent to easily check well known browsers and specific Internet Explorer versions.
Here is a sample:
Browser browser = new Browser(readableUserAgent);
browser.isIE();
browser.isFirefox();
browser.isOpera();
browser.isSafari();
browser.isGoogleChrome();
browser.isChromium();
browser.isIE6();
browser.isIE7();
// And more...
Sample
Here is a standard spring configuration:
package com.myApp;
import org.springframework.web.servlet.config.annotation.EnableWebMvc
import com.github.mjeanroy.springmvc.uadetector.configuration.EnableUADetector;
import com.github.mjeanroy.springmvc.uadetector.configuration.UACacheProvider;
@EnableWebMvc
@EnableUADetector(autowire = true, cache = UACacheProvider.AUTO)
public class MyAppConfiguration() {
}
Here is a spring mvc controller using arguments resolvers:
package com.myApp;
import net.sf.uadetector.ReadableUserAgent;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMethod;
@RestController
public class FirstController {
/**
* Return browser family.
* See how an instance of ReadableUserAgent can be used as
* a method parameter.
*
* @param userAgent Current user agent.
* @return Browser Family.
*/
@RequestMapping(value = "/ua/name", method = RequestMethod.GET)
public String index(ReadableUserAgent userAgent) {
return userAgent.getFamily().toString();
}
}
Here is a spring mvc controller using autowiring:
package com.myApp;
import net.sf.uadetector.ReadableUserAgent;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.bind.annotation.RequestMethod;
@RestController
public class SecondController {
@Autowire
private ReadableUserAgent userAgent;
/**
* Return browser family.
* See how an instance of ReadableUserAgent is automatically
* autowired.
*
* @return Browser Family.
*/
@RequestMapping(value = "/ua/name", method = RequestMethod.GET)
public String index() {
return userAgent.getFamily().toString();
}
}