Application: gvSIG desktop » gvSIG raster

<?xml version="1.0" encoding="ISO-8859-1"?>

<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

	<modelVersion>4.0.0</modelVersion>

	<artifactId>org.gvsig.raster.cache.lib.api</artifactId>

	<packaging>jar</packaging>

	<name>org.gvsig.raster.cache.lib.api</name>

	<parent>

		<groupId>org.gvsig</groupId>

		<artifactId>org.gvsig.raster.cache</artifactId>

		<version>2.2.1</version>

	</parent>

	<dependencies>

		<dependency>

            <groupId>org.gvsig</groupId>

            <artifactId>org.gvsig.tools.lib</artifactId>

            <type>test-jar</type>

            <scope>test</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

            <artifactId>org.gvsig.compat.api</artifactId>

            <scope>compile</scope>

        </dependency>

        <dependency>

            <groupId>org.gvsig</groupId>

            <artifactId>org.gvsig.compat.se</artifactId>

            <scope>compile</scope>

        </dependency>

     </dependencies>

	<build>

		<plugins>

			<plugin>

				<groupId>org.apache.maven.plugins</groupId>

				<artifactId>maven-jar-plugin</artifactId>

				<configuration>

				</configuration>

				<executions>

				<!--

				Generates a jar file only with the test classes

				-->

					<execution>

						<goals>

							<goal>test-jar</goal>

						</goals>

					</execution>

				</executions>

			</plugin>

		</plugins>

	</build>

</project>

org.gvsig.raster.cache.tile.TileCacheLibrary

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile;

import java.awt.geom.Point2D;

import java.awt.geom.Rectangle2D;

import org.gvsig.raster.cache.tile.pool.ThreadPool;

import org.gvsig.raster.cache.tile.provider.CacheStruct;

/**

 * This class is responsible of the management of the library's business logic.

 * It is the library's main entry point, and provides all the services to manage

 * {@link TileCacheService}s.

 * 

 * @author Nacho Brodin (nachobrodin@gmail.com)

 * @version $Id$

 */

public interface TileCacheManager {

	/**

	 * Builds a new entry point for a tile cache. The parameter is an identifier for a 

	 * tile cache structured implemented inside of this library

	 * @param baseDir

	 * @return

	 */

	public TileCache getTileCache(String baseDir);

	/**

	 * Creates a new tile structure

	 * @param level

	 * @param col

	 *        Tile column

	 * @param row

	 *        Tile row

	 * @return

	 */

	public Tile createTile(int level, int col, int row);

	/**

	 * Creates a new tile structure

	 * @param wPx

	 *        Width in pixels

	 * @param hPx

	 *        Height in pixels

	 * @param row

	 *        Tile row

	 * @param col

	 *        Tile column

	 * @param ul

	 *        Upper left coordinate

	 * @param lr

	 *        Lower roght coordinate 

	 * @return

	 */

	public Tile createTile(int wPx, int hPx, int row, int col, Point2D ul, Point2D lr);

	/**

	 * Builds a standard cache structure 

	 * @param typeOfCoords Constant defined in CacheStruct interface

	 * @param levels Number of levels

	 * @param layerExtent Bounding box of the layer

	 * @param pixelSize Pixel size of the layer

	 * @param tilePxWidth Width in pixels of a tile

	 * @param tilePxHeight Height in pixels of a tile

	 * @param uri server URL

	 * @param layerName Layer name or identifier

	 * @param strategy Strategy to store tiles in disk

	 * @param baseDir path to this layer

	 * @param fileSuffix File suffix

	 * @param epsg 

	 * @return

	 */

	public CacheStruct createCacheStructure(int typeOfCoords, 

    		int levels, 

    		Rectangle2D layerExtent, 

    		double pixelSize,

    		int tilePxWidth,

    		int tilePxHeight,

    		String uri,

    		String layerName,

    		String strategy,

    		String baseDir,

    		String fileSuffix,

    		String epsg,

    		long fileSize);

	/**

	 * Builds a standard cache structure for local files

	 * @param typeOfCoords Constant defined in CacheStruct interface

	 * @param levels Number of levels

	 * @param layerExtent Bounding box of the layer

	 * @param pixelSize Pixel size of the layer

	 * @param tilePxWidth Width in pixels of a tile

	 * @param tilePxHeight Height in pixels of a tile

	 * @param layerName Layer name or identifier

	 * @param strategy Strategy to store tiles in disk

	 * @param baseDir path to this layer

	 * @param fileSuffix File suffix

	 * @param epsg 

	 * @return

	 */

	public CacheStruct createCacheStructure(int typeOfCoords, 

    		int levels, 

    		Rectangle2D layerExtent, 

    		double pixelSize,

    		int tilePxWidth,

    		int tilePxHeight,

    		String layerName,

    		String strategy,

    		String baseDir,

    		String fileSuffix,

    		String epsg,

    		long fileSize);

	/**

	 * Builds a new thread pool. This pool will use five threads by default

	 * @return

	 */

	public ThreadPool createThreadPool(boolean priorityActive);

	/**

	 * Builds a new thread pool selecting the number of threads

	 * @return

	 */

	public ThreadPool createThreadPool(boolean priorityActive, int nThreads);

	/**

	 * Sets the time out in milliseconds

	 * @param ms

	 */

	public void setTileTimeOut(int ms);

	/**

	 * Gets the time out in milliseconds

	 * @return

	 */

	public int getTileTimeOut();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.layer;

import java.util.List;

import org.gvsig.raster.cache.tile.Tile;

import org.gvsig.raster.cache.tile.exception.TileGettingException;

import org.gvsig.raster.cache.tile.provider.TileListener;

import org.gvsig.tools.task.TaskStatus;

/**

 * API interface for a cached layer

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface TiledLayer {

	/**

	 * Gets a tile

	 * @param tile

	 * @return

	 * @throws TileGettingException 

	 */

	public Tile getTile(Tile tile) throws TileGettingException;

	/**

	 * Gets a list of tiles

	 * @param tiles

	 * @param listener

	 * @throws TileGettingException 

	 */

	public void getTiles(List<Tile> tiles, TileListener listener, TaskStatus status) throws TileGettingException;

	/**

	 * Gets the base directory for this layer. This function builds an unique identifier

	 * for a layer with a limited length.

	 * @return

	 */

	public String getBaseLayerDirectory();

	/**

	 * Returns the ID of this layer. 

	 * The ID is the name of the directory where the tiles are stored.

	 * @return

	 */

	public String getID();

	/**

	 * Deletes the files of this layer 

	 * @return Size of information that was deleted

	 */

	public long delete();

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.raster.cache.tile.layer package documentation</title>

</head>

<body>

	<p>Tile layer</p>

	<p>

	</p>

</body>

</html>

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile;

import java.awt.geom.Point2D;

import java.awt.geom.Rectangle2D;

import java.io.File;

import org.gvsig.raster.cache.tile.pool.AtomicTask;

import org.gvsig.raster.cache.tile.pool.TilePipe;

import org.gvsig.raster.cache.tile.provider.Downloader;

import org.gvsig.compat.net.ICancellable;

/**

 * Tile structure for requests

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface Tile extends AtomicTask {

	/**

	 * Gets the Variable that this tile belong to.This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a default value. 

	 * @return

	 */

	public String getVariable();

	/**

	 * Gets the Z that this tile belong to. This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a 0 value. 

	 * @return

	 */

	public String getZ();

	/**

	 * Gets the time instant that this tile belong to.This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a 0 value. 

	 * @return

	 */

	public String getTimeInstant();

	/**

	 * Sets the Variable that this tile belong to.This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a default value. 

	 * @return

	 */

	public void setVariable(String var);

	/**

	 * Sets the Z that this tile belong to. This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a 0 value. 

	 * @return

	 */

	public void setZ(String z);

	/**

	 * Sets the time instant that this tile belong to.This is useful when the source 

	 * is a multidimensional container. If it is not then this variable will have

	 * a 0 value. 

	 * @return

	 */

	public void setTimeInstant(String t);

	/**

	 * Gets the column of this tile

	 * @return

	 */

	public int getCol();

	/**

	 * Gets the row of this tile

	 * @return

	 */

	public int getRow();

	/**

	 * Gets the resolution level of this tile

	 * @return

	 */

	public int getLevel();

	/**

	 * Sets the column of this tile in its level

	 * @param col

	 */

	public void setCol(int col);

	/**

	 * Sets the row of this tile in its level

	 * @param col

	 */

	public void setRow(int row);

	/**

	 * Sets the level of resolution of this tile

	 * @param col

	 */

	public void setLevel(int level);

	/**

	 * Gets the coordinates in pixels of this tile inside the layer.

	 * This function is only for the real level. 

	 * @return

	 */

	public Rectangle2D getCoordsPx();

	/**

	 * Sets the coordinates ins pixels of this tile inside the layer.

	 * This function is only for the real level.

	 * @param r

	 */

	public void setCoordsPx(Rectangle2D r);

	/**

	 * Gets the width in pixels of this tile

	 * @return

	 */

	public int getWidthPx();

	/**

	 * Sets the width in pixels of this tile

	 * @param widthPx

	 */

	public void setWidthPx(int widthPx);

	/**

	 * Gets the height in pixels of this tile

	 * @return

	 */

	public int getHeightPx();

	/**

	 * Sets the height in pixels of this tile

	 * @param heightPx

	 */

	public void setHeightPx(int heightPx);

	/**

	 * Gets the bounding box

	 * @return

	 */

	public Rectangle2D getExtent();

	/**

	 * Gets the upper left coordinate of this tile

	 * @return

	 */

	public Point2D getUl();

	/**

	 * Sets the upper left coordinate of this tile

	 * @return

	 */

	public void setUl(Point2D ul);

	/**

	 * Gets the lower right coordinate of this tile

	 * @return

	 */

	public Point2D getLr();

	/**

	 * Sets the lower right coordinate of this tile

	 * @return

	 */

	public void setLr(Point2D lr);

	/**

	 * Gets the file associated to this tile

	 * @return

	 */

	public File getFile();

	/**

	 * Sets the file associated to this tile

	 * @param file

	 */

	public void setFile(File file);

	/**

	 * Gets an unique identifier to this tile

	 * @return

	 */

	public String getId();

	/**

	 * Gets the Downloader parameters

	 * @return

	 */

	public Object getDownloaderParams(String key);

	/**

	 * Sets the Downloader parameters

	 * @param downloaderParams

	 */

	public void setDownloaderParams(String key, Object downloaderParams);

	/**

	 * Sets the data associated to this tile. In the most cases

	 * will be only one element in the array of objects

	 * @param data

	 */

	public void setData(Object[] data);

	/**

	 * Gets the data associated to this tile. In the most cases

	 * will be only one element in the array of objects

	 * @return

	 */

	public Object[] getData();

	/**

	 * Returns true if the buffer data is loaded

	 * @return

	 */

	public boolean dataIsLoaded();	

	/**

	 * Sets this flag to true if the data is corrupt

	 * @param corrupt

	 */

	public void setCorrupt(boolean corrupt);

	/**

	 * Returns true if the downloaded tile is corrupt, so this can't be sent to the client 

	 * @return

	 */

	public boolean isCorrupt();

	/**

	 * Sets the pipe of tiles

	 * @param sharedPipe

	 */

	public void setSharedPipe(TilePipe sharedPipe);

	/**

	 * Sets the downloader for this tile

	 * @param downloader

	 */

	public void setDownloader(Downloader downloader);

	/**

	 * Gets the image that represent a tile while is downloading

	 * @return RGB image and an alpha band

	 * @deprecated

	 */

	public Object[] getDownloadingImage();

	/**

	 * Gets the image that represent a crash tile

	 * @return RGB image and an alpha band

	 * @deprecated

	 */

	public Object[] getCrashImage();

	/**

	 * Gets the image that represent a tile while is downloading

	 * @return ARGB image 

	 */

	public Object getDownloadingARGB();

	/**

	 * Gets the image that represent a crash tile

	 * @return ARGB image

	 */

	public Object getCrashARGB();

	/**

	 * Returns true if downloading has been canceled. This is useful when a tile is taking

	 * a lot of time. The task which will throw this action could cancel the process.

	 * @return

	 */

	public ICancellable getCancelled();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.exception;

/**

 * This exception is thrown when the pool of threads fails

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class TileGettingException extends Exception {

	private static final long serialVersionUID = 1L;

	String message;

	public TileGettingException() {

		super();

	}

	/**

	 * Crea TileGettingException.

	 *

	 * @param message

	 */

	public TileGettingException(String message) {

        super();

        this.message = message;

	}

	/**

	 * Crea TileGettingException.

	 *

	 * @param message

	 * @param cause

	 */

	public TileGettingException(String message, Throwable cause) {

		super(format(message, 200), cause);

	}

	/**

	  * Crea TileGettingException.

	 *

	 * @param cause

	 */

	public TileGettingException(Throwable cause) {

		super(cause);

	}

    /**

     * Cuts the message text to force its lines to be shorter or equal to 

     * lineLength.

     * @param message, the message.

     * @param lineLength, the max line length in number of characters.

     * @return the formated message.

     */

    private static String format(String message, int lineLength){

        if (message.length() <= lineLength) return message;

        String[] lines = message.split("\n");

        String theMessage = "";

        for (int i = 0; i < lines.length; i++) {

            String line = lines[i].trim();

            if (line.length()<lineLength)

                theMessage += line+"\n";

            else {

                String[] chunks = line.split(" ");

                String newLine = "";

                for (int j = 0; j < chunks.length; j++) {

                    int currentLength = newLine.length();

                    chunks[j] = chunks[j].trim();

                    if (chunks[j].length()==0)

                        continue;

                    if ((currentLength + chunks[j].length() + " ".length()) <= lineLength)

                        newLine += chunks[j] + " ";

                    else {

                        newLine += "\n"+chunks[j]+" ";

                        theMessage += newLine;

                        newLine = "";

                    }

                }

            }

        }

        return theMessage;

    }

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.raster.cache.tile.exception package documentation</title>

</head>

<body>

	<p>Exceptions which are thrown by a wrong access to tile structures</p>

	<p>

	</p>

</body>

</html>

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.exception;

/**

 * This exception is thrown when the pool of threads fails

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class ThreadPoolException extends Exception {

	private static final long serialVersionUID = 1L;

	String message;

	public ThreadPoolException() {

		super();

	}

	/**

	 * Crea ThreadPoolException.

	 *

	 * @param message

	 */

	public ThreadPoolException(String message) {

        super();

        this.message = message;

	}

	/**

	 * Crea ThreadPoolException.

	 *

	 * @param message

	 * @param cause

	 */

	public ThreadPoolException(String message, Throwable cause) {

		super(format(message, 200), cause);

	}

	/**

	  * Crea ThreadPoolException.

	 *

	 * @param cause

	 */

	public ThreadPoolException(Throwable cause) {

		super(cause);

	}

    /**

     * Cuts the message text to force its lines to be shorter or equal to 

     * lineLength.

     * @param message, the message.

     * @param lineLength, the max line length in number of characters.

     * @return the formated message.

     */

    private static String format(String message, int lineLength){

        if (message.length() <= lineLength) return message;

        String[] lines = message.split("\n");

        String theMessage = "";

        for (int i = 0; i < lines.length; i++) {

            String line = lines[i].trim();

            if (line.length()<lineLength)

                theMessage += line+"\n";

            else {

                String[] chunks = line.split(" ");

                String newLine = "";

                for (int j = 0; j < chunks.length; j++) {

                    int currentLength = newLine.length();

                    chunks[j] = chunks[j].trim();

                    if (chunks[j].length()==0)

                        continue;

                    if ((currentLength + chunks[j].length() + " ".length()) <= lineLength)

                        newLine += chunks[j] + " ";

                    else {

                        newLine += "\n"+chunks[j]+" ";

                        theMessage += newLine;

                        newLine = "";

                    }

                }

            }

        }

        return theMessage;

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.exception;

/**

 * This exception is thrown when the pool of threads fails

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class TileBuildException extends Exception {

	private static final long serialVersionUID = 1L;

	String message;

	public TileBuildException() {

		super();

	}

	/**

	 * Crea TileGettingException.

	 *

	 * @param message

	 */

	public TileBuildException(String message) {

        super();

        this.message = message;

	}

	/**

	 * Crea TileGettingException.

	 *

	 * @param message

	 * @param cause

	 */

	public TileBuildException(String message, Throwable cause) {

		super(format(message, 200), cause);

	}

	/**

	  * Crea TileGettingException.

	 *

	 * @param cause

	 */

	public TileBuildException(Throwable cause) {

		super(cause);

	}

    /**

     * Cuts the message text to force its lines to be shorter or equal to 

     * lineLength.

     * @param message, the message.

     * @param lineLength, the max line length in number of characters.

     * @return the formated message.

     */

    private static String format(String message, int lineLength){

        if (message.length() <= lineLength) return message;

        String[] lines = message.split("\n");

        String theMessage = "";

        for (int i = 0; i < lines.length; i++) {

            String line = lines[i].trim();

            if (line.length()<lineLength)

                theMessage += line+"\n";

            else {

                String[] chunks = line.split(" ");

                String newLine = "";

                for (int j = 0; j < chunks.length; j++) {

                    int currentLength = newLine.length();

                    chunks[j] = chunks[j].trim();

                    if (chunks[j].length()==0)

                        continue;

                    if ((currentLength + chunks[j].length() + " ".length()) <= lineLength)

                        newLine += chunks[j] + " ";

                    else {

                        newLine += "\n"+chunks[j]+" ";

                        theMessage += newLine;

                        newLine = "";

                    }

                }

            }

        }

        return theMessage;

    }

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.raster.cache.tile package documentation</title>

</head>

<body>

	<p>Base classes to get tiles from raster layers</p>

	<p>

	</p>

</body>

</html>

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile;

import org.gvsig.raster.cache.tile.layer.TiledLayer;

import org.gvsig.raster.cache.tile.provider.TileServer;

/**

 * Main API interface for the tile cache

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface TileCache {

	/**

	 * Builds a new layer

	 * @param provider

	 * @param diskStructure

	 * @return

	 */

	public TiledLayer createLayer(TileServer provider, String diskStructure);

	/**

	 * Removes a layer from list.

	 * @param layer

	 */

	public void removeLayer(TiledLayer layer);

	/**

	 * Returns true if the size of data in disk is greater than the MAX_CACHE_SIZE

	 * @return

	 */

	public boolean isFullDiskCache();

	/**

	 * Updates the string with the base directory

	 * @param dir

	 */

	public void updateBaseDirectory(String dir);

	/**

	 * Gets the configuration directory

	 * @return

	 */

	public String getConfigurationDirectory();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile;

import org.gvsig.tools.locator.BaseLocator;

import org.gvsig.tools.locator.Locator;

import org.gvsig.tools.locator.LocatorException;

/**

 * This locator is the entry point for the Raster library, providing

 * access to all Raster services through the {@link TileCacheManager}

 * .

 * 

 * @author gvSIG team

 * @version $Id$

 */

public class TileCacheLocator extends BaseLocator {

    public static final String             MANAGER_NAME            = "TileCache.manager";

    public static final String             MANAGER_DESCRIPTION     = "TileCache Manager";

    private static final String            LOCATOR_NAME            = "TileCache.locator";

    private static final TileCacheLocator  INSTANCE                = new TileCacheLocator();

    /**

     * Return the singleton instance.

     * 

     * @return the singleton instance

     */

    public static TileCacheLocator getInstance() {

        return INSTANCE;

    }

    /**

     * Return the Locator's name.

     * 

     * @return a String with the Locator's name

     */

    public final String getLocatorName() {

        return LOCATOR_NAME;

    }

    /**

     * Return a reference to the RasterManager.

     * 

     * @return a reference to the RasterManager

     * @throws LocatorException

     *             if there is no access to the class or the class cannot be

     *             instantiated

     * @see Locator#get(String)

     */

    public static TileCacheManager getManager() throws LocatorException {

        return (TileCacheManager) getInstance().get(MANAGER_NAME);

    }

    /**

     * Registers the Class implementing the RasterManager interface.

     * 

     * @param clazz

     *            implementing the RasterManager interface

     */

    public static void registerManager(

        Class<? extends TileCacheManager> clazz) {

        getInstance().register(MANAGER_NAME, MANAGER_DESCRIPTION, clazz);

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile;

import org.gvsig.tools.library.AbstractLibrary;

import org.gvsig.tools.library.LibraryException;

import org.gvsig.tools.locator.ReferenceNotRegisteredException;

/**

 * 

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public class TileCacheLibrary extends AbstractLibrary {

	public static int                 DEFAULT_LEVELS       = 25; 

	public static int                 DEFAULT_TILEWIDTH    = 256;

	public static int                 DEFAULT_TILEHEIGHT   = 256;

	public static int                 ALTERNATIVE_TILESIZE = 1024;

	public static String              DEFAULT_STRUCTURE    = "FLATX";

	//One directory X dimension. The name of each tile is the Y coordinate. 

	public static String              FLATX_STRUCT         = "FLATX";

	public static String              QUADKEY_STRUCT       = "QUADKEY";

	public static int                 MAX_CACHE_SIZE       = 5000;

	public TileCacheLibrary() {

        registerAsAPI(TileCacheLibrary.class);

	}

	@Override

    protected void doInitialize() throws LibraryException {

    }

    @Override

    protected void doPostInitialize() throws LibraryException {

        TileCacheManager manager = TileCacheLocator.getManager();

        if (manager == null) {

            throw new ReferenceNotRegisteredException(

                TileCacheLocator.MANAGER_NAME, TileCacheLocator

                    .getInstance());

        }

    }

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.pool;

/**

 * This class manages transactions between the producer and the consumer. The

 * producer download tiles from a server and the consumer is a tile provider

 * which will return downloaded tiles.

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface TilePipe {

	/**

	 * Sets a tile in the pipe

	 * @param tile

	 */

	public void setAtomicTask(AtomicTask tile);

	/**

	 * Gets a tile from the pipe

	 * @return

	 */

	public AtomicTask getAtomicTask();

	/**

	 * Returns the number of elements in the queue

	 * @return

	 */

	public int getSize();

	/**

	 * Cleans the queue

	 */

	public void clear();

}

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

<html xmlns="http://www.w3.org/1999/xhtml">

<head>

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />

<title>org.gvsig.raster.cache.tile.pool package documentation</title>

</head>

<body>

	<p>API to build a pool of threads of tasks</p>

	<p>

	</p>

</body>

</html>

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.pool;

/**

 * Task with priorities

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface AtomicTask extends Runnable, Comparable<AtomicTask> {

	/**

	 * Gets the priority of this task

	 * @return

	 */

	public int getPriority();

	/**

	 * Sets the priority of this task

	 * @param priority

	 */

	public void setPriority(int priority);

	/**

	 * Cancels this current task

	 */

	public void cancelTask();

}

/* gvSIG. Geographic Information System of the Valencian Government

 *

 * Copyright (C) 2007-2008 Infrastructures and Transports Department

 * of the Valencian Government (CIT)

 *

 * This program is free software; you can redistribute it and/or

 * modify it under the terms of the GNU General Public License

 * as published by the Free Software Foundation; either version 2

 * of the License, or (at your option) any later version.

 *

 * This program is distributed in the hope that it will be useful,

 * but WITHOUT ANY WARRANTY; without even the implied warranty of

 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the

 * GNU General Public License for more details.

 *

 * You should have received a copy of the GNU General Public License

 * along with this program; if not, write to the Free Software

 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,

 * MA  02110-1301, USA.

 *

 */

package org.gvsig.raster.cache.tile.pool;

import java.util.LinkedList;

/**

 * Pool of threads. This class contains a list of tasks and a limited number

 * of threads to execute them. When a thread is free will execute the next task 

 * in the list. 

 *

 * @author Nacho Brodin (nachobrodin@gmail.com)

 */

public interface ThreadPool {

	/**

	 * Stops all threads in the list and sets the list to null

	 */

	public void destroyPool();

	/**

	 * Adds a new task to the list

	 * @param task

	 */