com.maxmind.db

Class Reader

java.lang.Object

com.maxmind.db.Reader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public final class Reader
extends java.lang.Object
implements java.io.Closeable

Instances of this class provide a reader for the MaxMind DB format. IP addresses can be looked up using the get method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Reader.FileMode The file mode to use when opening a MaxMind DB.

Constructor Summary

Constructors

Constructor and Description
Reader(java.io.File database) Constructs a Reader for the MaxMind DB format.
Reader(java.io.File database, Reader.FileMode fileMode) Constructs a Reader for the MaxMind DB format.
Reader(java.io.InputStream source) Constructs a Reader as if in mode Reader.FileMode.MEMORY, without using a File instance.

Method Summary

Modifier and Type	Method and Description
void	close() Closes the MaxMind DB and returns resources to the system.
com.fasterxml.jackson.databind.JsonNode	get(java.net.InetAddress ipAddress) Looks up the address in the MaxMind DB.

Methods inherited from class java.lang.Object

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

Constructor Detail

Reader

public Reader(java.io.File database)
       throws java.io.IOException

Constructs a Reader for the MaxMind DB format. The file passed to it must be a valid MaxMind DB file such as a GeoIP2 database file.

Parameters:

database - the MaxMind DB file to use.

Throws:

java.io.IOException - if there is an error opening or reading from the file.

Reader

public Reader(java.io.InputStream source)
       throws java.io.IOException

Constructs a Reader as if in mode Reader.FileMode.MEMORY, without using a File instance.

Parameters:

source - the InputStream that contains the MaxMind DB file.

Throws:

java.io.IOException - if there is an error reading from the Stream.

Reader

public Reader(java.io.File database,
              Reader.FileMode fileMode)
       throws java.io.IOException

Constructs a Reader for the MaxMind DB format. The file passed to it must be a valid MaxMind DB file such as a GeoIP2 database file.

Parameters:

database - the MaxMind DB file to use.

fileMode - the mode to open the file with.

Throws:

java.io.IOException - if there is an error opening or reading from the file.

Method Detail

get

public com.fasterxml.jackson.databind.JsonNode get(java.net.InetAddress ipAddress)
                                            throws java.io.IOException

Looks up the address in the MaxMind DB.

Parameters:

ipAddress - the IP address to look up.

Returns:

the record for the IP address.

Throws:

java.io.IOException - if a file I/O error occurs.

close

public void close()
           throws java.io.IOException

Closes the MaxMind DB and returns resources to the system.

Specified by:

close in interface java.io.Closeable

Specified by:

close in interface java.lang.AutoCloseable

Throws:

java.io.IOException - if an I/O error occurs.