Package com.maxmind.geoip
Class LookupService
java.lang.Object
com.maxmind.geoip.LookupService
Provides a lookup service for information based on an IP address. The
location of a database file is supplied when creating a lookup service
instance. The edition of the database determines what information is
available about an IP address. See the DatabaseInfo class for further
details.
The following code snippet demonstrates looking up the country that an IP address is from:
// First, create a LookupService instance with the location of the database. LookupService lookupService = new LookupService("c:\\geoip.dat"); // Assume we have a String ipAddress (in dot-decimal form). Country country = lookupService.getCountry(ipAddress); System.out.println("The country is: " + country.getName()); System.out.println("The country code is: " + country.getCode());In general, a single LookupService instance should be created and then reused repeatedly.
Tip: Those deploying the GeoIP API as part of a web application may find it difficult to pass in a File to create the lookup service, as the location of the database may vary per deployment or may even be part of the web-application. In this case, the database should be added to the classpath of the web-app. For example, by putting it into the WEB-INF/classes directory of the web application. The following code snippet demonstrates how to create a LookupService using a database that can be found on the classpath:
String fileName = getClass().getResource("/GeoIP.dat").toExternalForm() .substring(6); LookupService lookupService = new LookupService(fileName);
- Author:
- Matt Tucker (matt@jivesoftware.com)
-
Field Summary
Modifier and TypeFieldDescriptionstatic final int
static final int
static final int
static final int
static final int
static final int
static final int
static final int
-
Constructor Summary
ConstructorDescriptionLookupService
(File databaseFile) Create a new lookup service using the specified database file.LookupService
(File databaseFile, int options) Create a new lookup service using the specified database file.LookupService
(String databaseFile) Create a new lookup service using the specified database file.LookupService
(String databaseFile, int options) Create a new lookup service using the specified database file. -
Method Summary
Modifier and TypeMethodDescription(package private) void
void
close()
Closes the lookup service.void
countryToIP
(String country, Writer out) I2P - Write all IPv4 address ranges for the given country to out.getCountry
(long ipAddress) Returns the country the IP address is in.getCountry
(String ipAddress) Returns the country the IP address is in.getCountry
(InetAddress ipAddress) Returns the country the IP address is in.getCountryV6
(String ipAddress) Returns the country the IP address is in.getCountryV6
(InetAddress addr) Returns the country the IP address is in.Returns information about the database.int
getID
(long ipAddress) int
int
getID
(InetAddress ipAddress) getLocation
(long ipnum) getLocation
(String str) getLocation
(InetAddress addr) getLocationV6
(String str) getLocationV6
(InetAddress addr) getOrg
(long ipnum) getOrg
(InetAddress addr) getOrgV6
(InetAddress addr) getRegion
(long ipnum) getRegion
(InetAddress addr) int
void
netmask
(int nm)
-
Field Details
-
GEOIP_STANDARD
public static final int GEOIP_STANDARD- See Also:
-
GEOIP_MEMORY_CACHE
public static final int GEOIP_MEMORY_CACHE- See Also:
-
GEOIP_CHECK_CACHE
public static final int GEOIP_CHECK_CACHE- See Also:
-
GEOIP_INDEX_CACHE
public static final int GEOIP_INDEX_CACHE- See Also:
-
GEOIP_UNKNOWN_SPEED
public static final int GEOIP_UNKNOWN_SPEED- See Also:
-
GEOIP_DIALUP_SPEED
public static final int GEOIP_DIALUP_SPEED- See Also:
-
GEOIP_CABLEDSL_SPEED
public static final int GEOIP_CABLEDSL_SPEED- See Also:
-
GEOIP_CORPORATE_SPEED
public static final int GEOIP_CORPORATE_SPEED- See Also:
-
-
Constructor Details
-
LookupService
Create a new lookup service using the specified database file.- Parameters:
databaseFile
- String representation of the database file.- Throws:
IOException
- if an error occured creating the lookup service from the database file.
-
LookupService
Create a new lookup service using the specified database file.- Parameters:
databaseFile
- the database file.- Throws:
IOException
- if an error occured creating the lookup service from the database file.
-
LookupService
Create a new lookup service using the specified database file.- Parameters:
databaseFile
- String representation of the database file.options
- database flags to use when opening the database GEOIP_STANDARD read database from disk GEOIP_MEMORY_CACHE cache the database in RAM and read it from RAM- Throws:
IOException
- if an error occured creating the lookup service from the database file.
-
LookupService
Create a new lookup service using the specified database file.- Parameters:
databaseFile
- the database file.options
- database flags to use when opening the database GEOIP_STANDARD read database from disk GEOIP_MEMORY_CACHE cache the database in RAM and read it from RAM- Throws:
IOException
- if an error occured creating the lookup service from the database file.
-
-
Method Details
-
close
public void close()Closes the lookup service. -
getAllCountryNames
- Returns:
- The list of all known country names
-
getAllCountryCodes
- Returns:
- The list of all known country codes
-
getCountryV6
Returns the country the IP address is in.- Parameters:
ipAddress
- String version of an IPv6 address, i.e. "::127.0.0.1"- Returns:
- the country the IP address is from.
-
getCountry
Returns the country the IP address is in.- Parameters:
ipAddress
- String version of an IP address, i.e. "127.0.0.1"- Returns:
- the country the IP address is from.
-
getCountry
Returns the country the IP address is in.- Parameters:
ipAddress
- the IP address.- Returns:
- the country the IP address is from.
-
getCountryV6
Returns the country the IP address is in.- Parameters:
addr
- the IP address as Inet6Address.- Returns:
- the country the IP address is from.
-
getCountry
Returns the country the IP address is in.- Parameters:
ipAddress
- the IP address in long format.- Returns:
- the country the IP address is from.
-
countryToIP
I2P - Write all IPv4 address ranges for the given country to out.- Parameters:
country
- two-letter case-insensitiveout
- caller must close- Throws:
IOException
- Since:
- 0.9.48
-
getID
-
getID
-
getID
public int getID(long ipAddress) -
last_netmask
public int last_netmask() -
netmask
public void netmask(int nm) -
getDatabaseInfo
Returns information about the database.- Returns:
- database info.
-
_check_mtime
void _check_mtime() -
getLocationV6
-
getLocation
-
getLocation
-
getRegion
-
getRegion
-
getRegion
-
getLocationV6
-
getLocation
-
getOrg
-
getOrg
-
getOrg
-
getOrgV6
-
getOrgV6
-