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

Modifier and Type	Method	Description
protected boolean	isAvailable()	Returns if the service provider is available to use.
protected RegionLocation	request(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

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

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:

isAvailable in class RegionLocationService

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:

request in class RegionLocationService

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.