├── .gitignore
├── .travis.yml
├── README.md
├── pom.xml
└── src
    ├── main
        ├── java
        │   └── mbtiles4j
        │   │   ├── MBTiles4jContextListener.java
        │   │   ├── MBTilesUtils.java
        │   │   └── TileServlet.java
        ├── resources
        │   └── mbtiles4j.properties
        └── webapp
        │   └── WEB-INF
        │       └── web.xml
    └── test
        ├── java
            └── mbtiles4j
            │   └── MBTilesUtilsTest.java
        └── resources
            ├── mbtiles4j.properties
            └── mbtiles4j
                └── mbtiles4j-test.mbtiles


/.gitignore:
--------------------------------------------------------------------------------
1 | .DS_Store
2 | .classpath
3 | .project
4 | .settings
5 | target/
6 | 


--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | language: java
2 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | mbtiles4j
 2 | =========
 3 | 
 4 | An [MBTiles](https://github.com/mapbox/mbtiles-spec) server written in Java.
 5 | 
 6 | [![Build Status](https://travis-ci.org/jtreml/mbtiles4j.png?branch=master)](https://travis-ci.org/jtreml/mbtiles4j)
 7 | 
 8 | Configuration
 9 | -------------
10 | 
11 | Edit the ``mbtiles4j.properties`` file in ``src/main/resources`` to configure your [MBTiles](https://github.com/mapbox/mbtiles-spec) databases:
12 | 
13 | ```properties
14 | tile-dbs = db1,db2,db3
15 | 
16 | db1.path = /path/to/your/database1.mbtiles
17 | db2.path = /path/to/your/database2.mbtiles
18 | db3.path = /path/to/your/database3.mbtiles
19 | ```
20 | 
21 | The name specified in this file will be the name used in the URL to access the tiles, e.g. the _db1_ tiles in the example configuration will be available at ``htp://<address>:<port>/mbtiles4j/db1/z/x/y.png``.
22 | 
23 | Build & Deployment
24 | ------------------
25 | 
26 | Type in 
27 | 
28 | ```
29 | mvn package
30 | ```
31 | 
32 | and deploy the ``mbtiles4j.war`` file found in ``target/`` to an application server of your choice.
33 | 
34 | Usage Example (Leaflet)
35 | -----------------------
36 | 
37 | This is an example of how to use the tile server as a source for a [Leaflet](http://leafletjs.com/)-based web app. Keep in mind that tiles are served according to [TMS](http://en.wikipedia.org/wiki/Tile_Map_Service) spec, i.e. you'll get a twisted map with mixed-up tiles unless you configure your maps solution accordingly.
38 | 
39 | ```javascript
40 |   <script src="leaflet.js"></script>
41 |   <script>
42 |     var map = L.map('map');
43 |     L.tileLayer('http://localhost:8080/mbtiles4j/db1/{z}/{x}/{y}.png', {
44 |       tms: true
45 |     }).addTo(map);
46 |   </script>
47 | ```
48 | 


--------------------------------------------------------------------------------
/pom.xml:
--------------------------------------------------------------------------------
  1 | <?xml version="1.0" encoding="UTF-8"?>
  2 | <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3 | 	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  4 | 	<groupId>mbtiles4j</groupId>
  5 | 	<version>0.0.1-SNAPSHOT</version>
  6 | 	<modelVersion>4.0.0</modelVersion>
  7 | 	<artifactId>mbtiles4j</artifactId>
  8 | 	<packaging>war</packaging>
  9 | 	<name>mbtiles4j</name>
 10 | 
 11 | 	<prerequisites>
 12 | 		<maven>2.2.1</maven>
 13 | 	</prerequisites>
 14 | 
 15 | 	<properties>
 16 | 		<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
 17 | 	</properties>
 18 | 
 19 | 	<dependencies>
 20 | 		<dependency>
 21 | 			<groupId>commons-io</groupId>
 22 | 			<artifactId>commons-io</artifactId>
 23 | 			<version>2.4</version>
 24 | 		</dependency>
 25 | 		<dependency>
 26 | 			<groupId>org.apache.commons</groupId>
 27 | 			<artifactId>commons-lang3</artifactId>
 28 | 			<version>3.1</version>
 29 | 		</dependency>
 30 | 		<dependency>
 31 | 			<groupId>javax.servlet</groupId>
 32 | 			<artifactId>javax.servlet-api</artifactId>
 33 | 			<version>3.1.0</version>
 34 | 			<scope>provided</scope>
 35 | 		</dependency>
 36 | 		<dependency>
 37 | 			<groupId>org.xerial</groupId>
 38 | 			<artifactId>sqlite-jdbc</artifactId>
 39 | 			<version>3.7.2</version>
 40 | 		</dependency>
 41 | 		<dependency>
 42 | 			<groupId>junit</groupId>
 43 | 			<artifactId>junit</artifactId>
 44 | 			<version>4.11</version>
 45 | 			<scope>test</scope>
 46 | 		</dependency>
 47 | 	</dependencies>
 48 | 
 49 | 	<build>
 50 | 		<finalName>mbtiles4j</finalName>
 51 | 		<plugins>
 52 | 			<plugin>
 53 | 				<groupId>org.apache.maven.plugins</groupId>
 54 | 				<artifactId>maven-compiler-plugin</artifactId>
 55 | 				<version>3.1</version>
 56 | 				<configuration>
 57 | 					<source>1.6</source>
 58 | 					<target>1.6</target>
 59 | 				</configuration>
 60 | 			</plugin>
 61 | 			<plugin>
 62 | 				<groupId>org.apache.maven.plugins</groupId>
 63 | 				<artifactId>maven-war-plugin</artifactId>
 64 | 				<version>2.3</version>
 65 | 				<configuration>
 66 | 					<packagingExcludes>**/client/**</packagingExcludes>
 67 | 					<archive>
 68 | 						<manifest>
 69 | 							<addDefaultImplementationEntries>true</addDefaultImplementationEntries>
 70 | 							<addDefaultSpecificationEntries>true</addDefaultSpecificationEntries>
 71 | 						</manifest>
 72 | 					</archive>
 73 | 					<webXml>src/main/webapp/WEB-INF/web.xml</webXml>
 74 | 					<webResources>
 75 | 						<resource>
 76 | 							<directory>${basedir}/src/main/webapp/WEB-INF</directory>
 77 | 							<filtering>true</filtering>
 78 | 							<targetPath>WEB-INF</targetPath>
 79 | 							<includes>
 80 | 								<include>web.xml</include>
 81 | 							</includes>
 82 | 						</resource>
 83 | 					</webResources>
 84 | 				</configuration>
 85 | 			</plugin>
 86 | 			<plugin>
 87 | 				<groupId>org.codehaus.mojo</groupId>
 88 | 				<artifactId>versions-maven-plugin</artifactId>
 89 | 				<version>2.0</version>
 90 | 			</plugin>
 91 | 		</plugins>
 92 | 	</build>
 93 | 	<scm>
 94 | 		<connection>scm:git:git@github.com:jtreml/mbtiles4j.git</connection>
 95 | 		<developerConnection>scm:git:git@github.com:jtreml/mbtiles4j.git</developerConnection>
 96 | 		<url>https://github.com/jtreml/mbtiles4j</url>
 97 | 	</scm>
 98 | 	<issueManagement>
 99 | 		<system>GitHub Issues</system>
100 | 		<url>https://github.com/jtreml/mbtiles4j/issues</url>
101 | 	</issueManagement>
102 | 	<organization>
103 | 		<name>Jürgen Treml</name>
104 | 		<url>http://www.juergentreml.de</url>
105 | 	</organization>
106 | 	<ciManagement>
107 | 		<url>https://travis-ci.org/jtreml/mbtiles4j</url>
108 | 		<system>Travis CI</system>
109 | 	</ciManagement>
110 | </project>
111 | 


--------------------------------------------------------------------------------
/src/main/java/mbtiles4j/MBTiles4jContextListener.java:
--------------------------------------------------------------------------------
 1 | package mbtiles4j;
 2 | 
 3 | import javax.servlet.ServletContextEvent;
 4 | import javax.servlet.ServletContextListener;
 5 | 
 6 | public class MBTiles4jContextListener implements ServletContextListener {
 7 | 
 8 | 	@Override
 9 | 	public void contextInitialized(ServletContextEvent sce) {
10 | 		MBTilesUtils.connect();
11 | 	}
12 | 
13 | 	@Override
14 | 	public void contextDestroyed(ServletContextEvent sce) {
15 | 		MBTilesUtils.disconnect();
16 | 	}
17 | }
18 | 


--------------------------------------------------------------------------------
/src/main/java/mbtiles4j/MBTilesUtils.java:
--------------------------------------------------------------------------------
  1 | package mbtiles4j;
  2 | 
  3 | import java.io.File;
  4 | import java.io.IOException;
  5 | import java.sql.Connection;
  6 | import java.sql.DriverManager;
  7 | import java.sql.PreparedStatement;
  8 | import java.sql.ResultSet;
  9 | import java.sql.SQLException;
 10 | import java.util.HashMap;
 11 | import java.util.Map;
 12 | import java.util.Properties;
 13 | import java.util.concurrent.ConcurrentHashMap;
 14 | import java.util.regex.Pattern;
 15 | 
 16 | import org.apache.commons.lang3.StringUtils;
 17 | 
 18 | public class MBTilesUtils {
 19 | 
 20 | 	private static final ConcurrentHashMap<String, MBTilesUtils> INSTANCES = new ConcurrentHashMap<String, MBTilesUtils>();
 21 | 
 22 | 	private final Connection conn;
 23 | 
 24 | 	private final PreparedStatement ps;
 25 | 
 26 | 	private MBTilesUtils(String db) {
 27 | 		try {
 28 | 			Class.forName("org.sqlite.JDBC");
 29 | 		} catch (ClassNotFoundException e) {
 30 | 			throw new RuntimeException(e);
 31 | 		}
 32 | 
 33 | 		if (db == null || !new File(db).exists()) {
 34 | 			throw new RuntimeException("No database");
 35 | 		}
 36 | 
 37 | 		try {
 38 | 			conn = DriverManager.getConnection("jdbc:sqlite:" + db);
 39 | 		} catch (SQLException e) {
 40 | 			throw new RuntimeException(e);
 41 | 		}
 42 | 
 43 | 		try {
 44 | 			ps = conn.prepareStatement("SELECT tile_data FROM tiles "
 45 | 					+ "WHERE zoom_level = ? AND tile_column = ? "
 46 | 					+ "AND tile_row = ?;");
 47 | 		} catch (SQLException e) {
 48 | 			throw new RuntimeException(e);
 49 | 		}
 50 | 	}
 51 | 
 52 | 	static Map<String, String> getDatabases() {
 53 | 		Properties configuration = new Properties();
 54 | 		try {
 55 | 			configuration.load(MBTilesUtils.class.getClassLoader()
 56 | 					.getResourceAsStream("mbtiles4j.properties"));
 57 | 		} catch (IOException e) {
 58 | 			throw new RuntimeException(e);
 59 | 		}
 60 | 
 61 | 		HashMap<String, String> result = new HashMap<String, String>();
 62 | 
 63 | 		String dbs = configuration.getProperty("tile-dbs");
 64 | 		if (StringUtils.isEmpty(dbs)) {
 65 | 			return result;
 66 | 		}
 67 | 
 68 | 		String[] split = dbs.split(Pattern.quote(","));
 69 | 		for (String entry : split) {
 70 | 			String path = configuration.getProperty(entry + ".path");
 71 | 			if (!StringUtils.isEmpty(path)) {
 72 | 				result.put(entry, path);
 73 | 			}
 74 | 		}
 75 | 
 76 | 		return result;
 77 | 	}
 78 | 
 79 | 	public static MBTilesUtils getInstance(String db) {
 80 | 		return INSTANCES.get(db);
 81 | 	}
 82 | 
 83 | 	public synchronized byte[] getTiles(int x, int y, int z) {
 84 | 		int index = 1;
 85 | 
 86 | 		ResultSet rs = null;
 87 | 		try {
 88 | 			ps.setInt(index++, z);
 89 | 			ps.setInt(index++, x);
 90 | 			ps.setInt(index++, y);
 91 | 
 92 | 			rs = ps.executeQuery();
 93 | 			if (rs.next()) {
 94 | 				return rs.getBytes(1);
 95 | 			}
 96 | 		} catch (SQLException e) {
 97 | 			throw new RuntimeException(e);
 98 | 		} finally {
 99 | 			try {
100 | 				if (rs != null) {
101 | 					rs.close();
102 | 				}
103 | 			} catch (SQLException e) {
104 | 				e.printStackTrace();
105 | 			}
106 | 		}
107 | 
108 | 		return null;
109 | 	}
110 | 
111 | 	private synchronized void close() {
112 | 		if (ps != null) {
113 | 			try {
114 | 				ps.close();
115 | 			} catch (SQLException e) {
116 | 				e.printStackTrace();
117 | 			}
118 | 		}
119 | 		if (conn != null) {
120 | 			try {
121 | 				conn.close();
122 | 			} catch (SQLException e) {
123 | 				e.printStackTrace();
124 | 			}
125 | 		}
126 | 	}
127 | 
128 | 	public static void connect() {
129 | 		Map<String, String> dbs = getDatabases();
130 | 		for (String db : dbs.keySet()) {
131 | 			if (!INSTANCES.containsKey(db)) {
132 | 				INSTANCES.put(db, new MBTilesUtils(dbs.get(db)));
133 | 			}
134 | 		}
135 | 	}
136 | 
137 | 	public static void disconnect() {
138 | 		for (MBTilesUtils entry : INSTANCES.values()) {
139 | 			entry.close();
140 | 		}
141 | 	}
142 | }
143 | 


--------------------------------------------------------------------------------
/src/main/java/mbtiles4j/TileServlet.java:
--------------------------------------------------------------------------------
 1 | package mbtiles4j;
 2 | 
 3 | import java.io.IOException;
 4 | import java.util.regex.Pattern;
 5 | 
 6 | import javax.servlet.ServletException;
 7 | import javax.servlet.ServletOutputStream;
 8 | import javax.servlet.http.HttpServlet;
 9 | import javax.servlet.http.HttpServletRequest;
10 | import javax.servlet.http.HttpServletResponse;
11 | 
12 | import org.apache.commons.io.IOUtils;
13 | import org.apache.commons.lang3.StringUtils;
14 | 
15 | @SuppressWarnings("serial")
16 | public class TileServlet extends HttpServlet {
17 | 
18 | 	@Override
19 | 	protected void doGet(HttpServletRequest request,
20 | 			HttpServletResponse response) throws ServletException, IOException {
21 | 		String path = request.getPathInfo();
22 | 		if (StringUtils.isEmpty(path)) {
23 | 			response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
24 | 			return;
25 | 		}
26 | 
27 | 		path = path.substring(1);
28 | 		String[] split = path.split(Pattern.quote("/"));
29 | 
30 | 		if (split.length != 4) {
31 | 			response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
32 | 			return;
33 | 		}
34 | 
35 | 		if (!split[3].toLowerCase().endsWith(".png")) {
36 | 			response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
37 | 			return;
38 | 		}
39 | 
40 | 		split[3] = split[3].replace(".png", "");
41 | 
42 | 		MBTilesUtils mbtu = MBTilesUtils.getInstance(split[0]);
43 | 		if (mbtu == null) {
44 | 			response.setStatus(HttpServletResponse.SC_NOT_FOUND);
45 | 			return;
46 | 		}
47 | 
48 | 		int z;
49 | 		int y;
50 | 		int x;
51 | 		try {
52 | 			z = Integer.parseInt(split[1]);
53 | 			x = Integer.parseInt(split[2]);
54 | 			y = Integer.parseInt(split[3]);
55 | 		} catch (NumberFormatException e) {
56 | 			response.setStatus(HttpServletResponse.SC_BAD_REQUEST);
57 | 			return;
58 | 		}
59 | 
60 | 		byte[] tile = mbtu.getTiles(x, y, z);
61 | 		if (tile == null) {
62 | 			response.setStatus(HttpServletResponse.SC_NOT_FOUND);
63 | 			return;
64 | 		}
65 | 
66 | 		response.setContentType("image/png");
67 | 		response.setContentLength(tile.length);
68 | 
69 | 		ServletOutputStream oStream = response.getOutputStream();
70 | 		IOUtils.write(tile, oStream);
71 | 		oStream.flush();
72 | 		oStream.close();
73 | 	}
74 | 
75 | 	@Override
76 | 	protected void doPost(HttpServletRequest request,
77 | 			HttpServletResponse response) throws ServletException, IOException {
78 | 		doGet(request, response);
79 | 	}
80 | }
81 | 


--------------------------------------------------------------------------------
/src/main/resources/mbtiles4j.properties:
--------------------------------------------------------------------------------
1 | tile-dbs = db1,db2,db3
2 | 
3 | db1.path = /path/to/your/database.mbtiles
4 | db2.path = /path/to/your/database.mbtiles
5 | db3.path = /path/to/your/database.mbtiles
6 | 


--------------------------------------------------------------------------------
/src/main/webapp/WEB-INF/web.xml:
--------------------------------------------------------------------------------
 1 | <?xml version="1.0" encoding="UTF-8"?>
 2 | <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3 | 	xmlns="http://java.sun.com/xml/ns/javaee" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
 4 | 	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
 5 | 	id="WebApp_ID" version="2.5">
 6 | 	<display-name>mbtiles4j</display-name>
 7 | 	<servlet>
 8 | 		<servlet-name>Tile Servlet</servlet-name>
 9 | 		<servlet-class>mbtiles4j.TileServlet</servlet-class>
10 | 	</servlet>
11 | 	<servlet-mapping>
12 | 		<servlet-name>Tile Servlet</servlet-name>
13 | 		<url-pattern>/*</url-pattern>
14 | 	</servlet-mapping>
15 | 	<listener>
16 | 		<listener-class>mbtiles4j.MBTiles4jContextListener</listener-class>
17 | 	</listener>
18 | </web-app>
19 | 


--------------------------------------------------------------------------------
/src/test/java/mbtiles4j/MBTilesUtilsTest.java:
--------------------------------------------------------------------------------
 1 | package mbtiles4j;
 2 | 
 3 | import java.io.File;
 4 | import java.io.FileOutputStream;
 5 | import java.io.IOException;
 6 | import java.io.InputStream;
 7 | import java.io.OutputStream;
 8 | import java.util.Map;
 9 | 
10 | import org.apache.commons.io.IOUtils;
11 | import org.junit.AfterClass;
12 | import org.junit.Assert;
13 | import org.junit.BeforeClass;
14 | import org.junit.Test;
15 | 
16 | public class MBTilesUtilsTest {
17 | 
18 | 	private static MBTilesUtils mbtu;
19 | 
20 | 	private static String path;
21 | 
22 | 	@BeforeClass
23 | 	public static void extractTestDatabase() throws IOException {
24 | 		Map<String, String> dbs = MBTilesUtils.getDatabases();
25 | 		Assert.assertTrue(dbs.size() == 1);
26 | 
27 | 		String db = dbs.keySet().iterator().next();
28 | 		path = dbs.get(db);
29 | 
30 | 		InputStream is = null;
31 | 		OutputStream os = null;
32 | 		try {
33 | 			is = MBTilesUtilsTest.class.getResourceAsStream(path);
34 | 			os = new FileOutputStream(path);
35 | 			IOUtils.copy(is, os);
36 | 			os.flush();
37 | 		} finally {
38 | 			if (os != null) {
39 | 				os.close();
40 | 			}
41 | 			if (is != null) {
42 | 				is.close();
43 | 			}
44 | 		}
45 | 
46 | 		MBTilesUtils.connect();
47 | 		mbtu = MBTilesUtils.getInstance(db);
48 | 	}
49 | 
50 | 	@Test
51 | 	public void retrieveTiles() {
52 | 		check(0, 0, 0);
53 | 		checkNot(0, 1, 0);
54 | 		check(0, 1, 1);
55 | 		checkNot(0, 0, 3);
56 | 	}
57 | 
58 | 	@AfterClass
59 | 	public static void deleteTestDatabase() {
60 | 		MBTilesUtils.disconnect();
61 | 		new File(path).delete();
62 | 	}
63 | 
64 | 	private void check(int x, int y, int z) {
65 | 		byte[] tile = mbtu.getTiles(x, y, z);
66 | 		Assert.assertTrue(tile != null && tile.length > 0);
67 | 	}
68 | 
69 | 	private void checkNot(int x, int y, int z) {
70 | 		byte[] tile = mbtu.getTiles(x, y, z);
71 | 		Assert.assertTrue(tile == null);
72 | 	}
73 | }
74 | 


--------------------------------------------------------------------------------
/src/test/resources/mbtiles4j.properties:
--------------------------------------------------------------------------------
1 | tile-dbs = mbtiles4j-test
2 | 
3 | mbtiles4j-test.path = mbtiles4j-test.mbtiles
4 | 


--------------------------------------------------------------------------------
/src/test/resources/mbtiles4j/mbtiles4j-test.mbtiles:
--------------------------------------------------------------------------------
https://raw.githubusercontent.com/jtreml/mbtiles4j/54d8dc37da621e8a363cc6a9a7848a30e5a2846b/src/test/resources/mbtiles4j/mbtiles4j-test.mbtiles


--------------------------------------------------------------------------------