Package com.iizix.server.region
Class IPStack
- java.lang.Object
- com.iizix.geo.RegionLocationService
- com.iizix.server.region.IPStack
public class IPStack extends RegionLocationService
The "IPStack.com" service provider for region location information.- Author:
- Christopher Mindus
Field Summary
Fields inherited from class com.iizix.geo.RegionLocationService
ENCODING, ENCODING_NAME
Constructor Summary
Constructors Constructor Description IPStack(IWebServiceEngine wse, ServerSettings settings)Constructs the service provider for the region location information.
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description protected booleanisAvailable()Returns if the service provider is available to use.protected RegionLocationrequest(java.lang.String ipAddress)Requests region location information from the service provider.Methods inherited from class com.iizix.geo.RegionLocationService
configure, createRegionLocation, createRegionLocation, createRegionLocation, getDefaultName, getInstance, getName, getNames, initialize, isDisposed, onDisposed, parse, setGlobalCacheSize, shutdown
Constructor Detail
IPStack
public IPStack(IWebServiceEngine wse, ServerSettings settings)
Constructs the service provider for the region location information. The server will once constructed, register the service with its name. The name is "IPStack" and the default timeout is set to 20 seconds, but the site is really fast.- Parameters:
wse- The WebService engine used to determine proxy.settings- Server settings.
Method Detail
isAvailable
protected boolean isAvailable()
Returns if the service provider is available to use.Subclasses override this method to return another value than
true.- Overrides:
isAvailablein classRegionLocationService- Returns:
- true for OK to use, false if not properly configured.
request
protected RegionLocation request(java.lang.String ipAddress) throws java.io.IOException, java.io.InterruptedIOException, java.lang.InterruptedException
Requests region location information from the service provider. When the request has completed with or without error, call- Specified by:
requestin classRegionLocationService- Parameters:
ipAddress- The IP address request.- Returns:
- The region location information, must always be non-null.
- Throws:
java.io.IOException- For I/O errors.java.io.InterruptedIOException- If an I/O operation is interrupted.java.lang.InterruptedException- If thread is interrupted.