Application: gvSIG desktop

package org.gvsig.remoteclient.wms;

import java.io.ByteArrayInputStream;

import java.io.File;

import java.io.FileInputStream;

import java.io.FileReader;

import java.io.IOException;

import java.io.InputStream;

import java.net.URL;

import java.net.URLConnection;

import java.nio.ByteBuffer;

import java.nio.channels.FileChannel;

import java.util.ArrayList;

import java.util.StringTokenizer;

import java.util.TreeMap;

import org.gvsig.remoteclient.exceptions.ServerErrorException;

import org.gvsig.remoteclient.exceptions.WMSException;

import org.gvsig.remoteclient.ogc.OGCProtocolHandler;

import org.gvsig.remoteclient.ogc.OGCServiceInformation;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

import org.gvsig.remoteclient.utils.ExceptionTags;

import org.gvsig.remoteclient.utils.Utilities;

import org.gvsig.remoteclient.wms.request.WMSGetFeatureInfoRequest;

import org.gvsig.remoteclient.wms.request.WMSGetLegendGraphicRequest;

import org.gvsig.remoteclient.wms.request.WMSGetMapRequest;

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParserException;

/**

 * <p> Abstract class that represents handlers to comunicate via WMS protocol.

 * </p>

 *

 */

public abstract class WMSProtocolHandler extends OGCProtocolHandler{

	/**

	 * Encoding used to parse different xml documents.

	 */

	protected String encoding = "UTF-8";

    /**

     * WMS metadata

     */

    protected WMSServiceInformation serviceInfo;

    public TreeMap layers;

    public WMSLayer rootLayer;

    /**

     * returns the alfanumeric information of the layers at the specified point.

     * the diference between the other getfeatureInfo method is that this will

     * be implemented by each specific version because the XML from the server will be

     * parsed and presented by a well known structure.

     */

    public String getName() {

    	return name;

    }

    /*

     * (non-Javadoc)

     * @see org.gvsig.remoteClient.ogc.OGCProtocolHandler#getServiceInformation()

     */

    public OGCServiceInformation getServiceInformation() {

        return serviceInfo;

    }

    /**

	 * <p>Builds a GetCapabilities request that is sent to the WMS

	 * the response will be parse to extract the data needed by the

	 * WMS client</p>

	 * @param override, if true the previous downloaded data will be overridden

	 */

    public void getCapabilities(WMSStatus status, boolean override, ICancellable cancel)

    {

    	URL request = null;

		try

		{

			request = new URL(buildCapabilitiesRequest(status));

		}

		catch(Exception e)

		{

			e.printStackTrace();

		}

		try

		{

			if (override)

				Utilities.removeURL(request);

			File f = Utilities.downloadFile(request,"wms_capabilities.xml", cancel);

			if (f == null)

				return;

			clear();

			parseCapabilities(f);

	    } catch(Exception e)

		{

			//TODO

			e.printStackTrace();

		}

    }

    private void clear() {

		layers.clear();

		serviceInfo.clear();

	}

	/**

     * <p>It will send a GetFeatureInfo request to the WMS

     * Parsing the response and redirecting the info to the WMS client</p>

     * TODO: return a stored file instead a String.

     */

    public String getFeatureInfo(WMSStatus status, int x, int y, int featureCount, ICancellable cancel)

    {

    	StringBuffer output = new StringBuffer();

    	String outputFormat = new String();

    	String ServiceException = "ServiceExceptionReport";

    	StringBuffer sb = new StringBuffer();

    	sb.append("<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>");

		try

		{

			WMSGetFeatureInfoRequest request = createGetFeatureInfoRequest(status, x, y);

			URL url = request.getURL();

	    	outputFormat = url.openConnection().getContentType();

	    	File f = request.sendRequest();

			if (f == null){

				return "";

			}

			FileReader fReader = new FileReader(f);

			char[] buffer = new char[1024*256];

			for (int i = fReader.read(buffer); i>0; i = fReader.read(buffer))

		    {

		    	String str = new String(buffer,0,i);

		    	output.append(str);

		    }

		    if ( (outputFormat == null) || (outputFormat.indexOf("xml") != -1)

		    		||output.toString().toLowerCase().startsWith("<?xml")

		    		||(outputFormat.indexOf("gml") != -1))

		    {

		    	int tag;

		    	KXmlParser kxmlParser = null;

		    	kxmlParser = new KXmlParser();

		    	//kxmlParser.setInput(new StringReader(output.toString()));

		    	kxmlParser.setInput(new FileReader(f));

		    	tag = kxmlParser.nextTag();

		    	if (kxmlParser.getName().compareTo(ServiceException)==0)

				{

		    		sb.append("<INFO>").append(parseException( output.toString().getBytes())).append("</INFO>");

		    		return sb.toString();

				}

				else if (kxmlParser.getName().compareToIgnoreCase("ERROR")==0)

				{

					return output.toString();

				}

				else

				{

					return output.toString();

				}

	    	}

	    	else

	    	{  		

	    		//Para que funcione con el GetFeatureInfo Viewer generico hay que devolver:

	    		 return output.toString();

	    	}

		}

    	catch(XmlPullParserException parserEx)

    	{

    		if (output.toString().toLowerCase().indexOf("xml") != -1)

    		{

    			return output.toString().trim();

    		}

    		else

    		{

    	   		sb.append("<INFO>").append("Info format not supported").append("</INFO>");

        		return sb.toString();

    		}

    	}

    	catch(Exception e)

    	{

    		e.printStackTrace();

    		sb.append("<INFO>").append("Info format not supported").append("</INFO>");

    		return sb.toString();

    	}

    }

    /**

     * <p>Builds a GetMap request that is sent to the WMS

     * the response (image) will be redirect to the

     * WMS client</p>

     */

    public byte[] _getMap(WMSStatus status) throws ServerErrorException, WMSException

    {

    	try

		{

			//TODO:

			//pass this buildXXXRequest to the WMSProtocolHandlerXXX: The request can depend on the WMS version.

			WMSGetMapRequest request = createGetMapRequest(status);

			URL url = request.getURL();

			URLConnection conn = url.openConnection();

			System.out.println(request.toString());

            String type = conn.getContentType();

	    	byte[] imageBytes = null;

	    	byte[] buffer = new byte[1024*256];

            InputStream is = conn.getInputStream();

	    	int readed = 0;

	    	for (int i = is.read(buffer); i>0; i = is.read(buffer)){

                // Creates a new buffer to contain the previous readed bytes and the next bunch of bytes

	    		byte[] buffered = new byte[readed+i];

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

	    			if (j<readed){

                        // puts the previously downloaded bytes into the image buffer

	    				buffered[j] = imageBytes[j];

	    			}

	    			else {

                        // appends the recently downloaded bytes to the image buffer.

	    				buffered[j] = buffer[j-readed];

	    			}

				}

	    		imageBytes = (byte[]) buffered.clone();

	    		readed += i;

	    	}

	    	if ((type !=null && !type.subSequence(0,5).equals("image"))

	    		||(Utilities.isTextData(imageBytes)))

	    	{

               	WMSException wmsEx = null;

            	String exceptionMessage = parseException(imageBytes);

                if (exceptionMessage==null)

                {

                 	String error = new String(imageBytes);

                	int pos = error.indexOf("<?xml");

                	if (pos!= -1)

                	{

                		String xml = error.substring(pos,error.length());

                		exceptionMessage = parseException(xml.getBytes());

                        if (exceptionMessage == null)

                        	exceptionMessage = new String(imageBytes);

                	}

                }

             	wmsEx = new WMSException(exceptionMessage);

            	wmsEx.setWMSMessage(new String(imageBytes));

                throw wmsEx;

            }

			return imageBytes;

		}

		catch(IOException e)

		{

			e.printStackTrace();

            throw new ServerErrorException();

		}

    }

    public File getLegendGraphic(WMSStatus status, String layerName, ICancellable cancel) throws ServerErrorException, WMSException

    {

    	try

		{

			WMSGetLegendGraphicRequest request = createGetLegendGraphicRequest(status, layerName);

			File f = request.sendRequest();

	    	if (f== null)

	    		return null;

            if (Utilities.isTextFile(f)) {

	    		FileInputStream fis = new FileInputStream(f);

	    		FileChannel fc = fis.getChannel();

	    		byte[] data = new byte[(int)fc.size()];

	    		ByteBuffer bb = ByteBuffer.wrap(data);

	    		fc.read(bb);

	    		WMSException wmsEx = null;

            	String exceptionMessage = parseException(data);

                if (exceptionMessage==null)

                {

                 	String error = new String(data);

                	int pos = error.indexOf("<?xml");

                	if (pos!= -1)

                	{

                		String xml = error.substring(pos,error.length());

                		exceptionMessage = parseException(xml.getBytes());

                	}

                    if (exceptionMessage == null)

                    	exceptionMessage = new String(data);

                }

             	wmsEx = new WMSException(exceptionMessage);

            	wmsEx.setWMSMessage(new String(data));

            	Utilities.removeURL(request);

                throw wmsEx;

            }

			return f;

		}

		catch(IOException e)

		{

			e.printStackTrace();

            throw new ServerErrorException();

		}

    }

    public File getMap(WMSStatus status, ICancellable cancel) throws ServerErrorException, WMSException

    {

    	try

		{

			WMSGetMapRequest request = createGetMapRequest(status);

			File f = request.sendRequest();

			if (f== null)

	    		return null;

            if (Utilities.isTextFile(f)) {

	    		FileInputStream fis = new FileInputStream(f);

	    		FileChannel fc = fis.getChannel();

	    		byte[] data = new byte[(int)fc.size()];   // fc.size returns the size of the file which backs the channel

	    		ByteBuffer bb = ByteBuffer.wrap(data);

	    		fc.read(bb);

	    		WMSException wmsEx = null;

            	String exceptionMessage = parseException(data);

                if (exceptionMessage==null)

                {

                 	String error = new String(data);

                	int pos = error.indexOf("<?xml");

                	if (pos!= -1)

                	{

                		String xml = error.substring(pos,error.length());

                		exceptionMessage = parseException(xml.getBytes());

//                        if (exceptionMessage == null)

//                        	exceptionMessage = new String(data);

                	}

                    if (exceptionMessage == null)

                    	exceptionMessage = new String(data);

                }

             	wmsEx = new WMSException(exceptionMessage);

            	wmsEx.setWMSMessage(new String(data));

            	// Since it is an error file, It must be deleted from the cache

            	Utilities.removeURL(request);

                throw wmsEx;

            }

			return f;

		}

		catch(IOException e)

		{

			e.printStackTrace();

            throw new ServerErrorException();

		}

    }

    /* (non-Javadoc)

     * @see org.gvsig.remoteClient.wms.WMSProtocolHandler#parseException(byte[])

     */

    protected String parseException(byte[] data) {

        ArrayList errors = new ArrayList();

        KXmlParser kxmlParser = new KXmlParser();

        try

        {

            kxmlParser.setInput(new ByteArrayInputStream(data), encoding);

            kxmlParser.nextTag();

            int tag;

            if ( kxmlParser.getEventType() != KXmlParser.END_DOCUMENT )

            {

                kxmlParser.require(KXmlParser.START_TAG, null, ExceptionTags.EXCEPTION_ROOT);

                tag = kxmlParser.nextTag();

                 while(tag != KXmlParser.END_DOCUMENT)

                 {

                     switch(tag)

                     {

                        case KXmlParser.START_TAG:

                            if (kxmlParser.getName().compareTo(ExceptionTags.SERVICE_EXCEPTION)==0){

                                String errorCode = kxmlParser.getAttributeValue("", ExceptionTags.CODE);

                                errorCode = (errorCode != null) ? "["+errorCode+"] " : "";

                                String errorMessage = kxmlParser.nextText();

                                errors.add(errorCode+errorMessage);

                            }

                            break;

                        case KXmlParser.END_TAG:

                            break;

                     }

                     tag = kxmlParser.nextTag();

                 }

                 //kxmlParser.require(KXmlParser.END_DOCUMENT, null, null);

            }

        }

        catch(XmlPullParserException parser_ex){

            parser_ex.printStackTrace();

        }

        catch (IOException ioe) {

            ioe.printStackTrace();

        }

        String message = errors.size()>0? "" : null;

        for (int i = 0; i < errors.size(); i++) {

            message += (String) errors.get(i)+"\n";

        }

        return message;

    }

    /**

     * Builds the GetCapabilitiesRequest according to the OGC WMS Specifications

     * without a VERSION, to get the highest version than a WMS supports.

     */

    public static String buildCapabilitiesSuitableVersionRequest(String _host, String _version)

    {

		int index = _host.indexOf('?');

		if (index > -1) {

			String host = _host.substring(0, index + 1);

			String query = _host.substring(index + 1, _host.length());

			StringTokenizer tokens = new StringTokenizer(query, "&");

			String newQuery = "", token;

			// If there is a field or a value with spaces, (and then it's on different tokens) -> unify them

			while (tokens.hasMoreTokens()) {

				token = tokens.nextToken().trim();

				if (token.toUpperCase().compareTo("REQUEST=GETCAPABILITIES") == 0)

					continue;

				if (token.toUpperCase().compareTo("SERVICE=WMS") == 0)

					continue;

				if ((_version != null) && (_version.length() > 0)) {

    				if (token.toUpperCase().compareTo("VERSION=" + _version) == 0)

    					continue;

				}

				if (token.toUpperCase().compareTo("EXCEPTIONS=XML") == 0)

					continue;

				newQuery += token + "&";

			}

        	_host = host + newQuery;

		}

		else {

			_host += "?";

		}

    	if ((_version != null) && (_version.compareTo("") != 0))

    		_host += "REQUEST=GetCapabilities&SERVICE=WMS&VERSION=" + _version + "&EXCEPTIONS=XML";

    	else

    		_host += "REQUEST=GetCapabilities&SERVICE=WMS&EXCEPTIONS=XML";

    	return _host;

    }

    /**

     * Builds the GetCapabilitiesRequest according to the OGC WMS Specifications

     * @param WMSStatus

     */

    private String buildCapabilitiesRequest(WMSStatus status)

    {

		StringBuffer req = new StringBuffer();

		String symbol = null;

		String onlineResource;

		if (status == null || status.getOnlineResource() == null)

			onlineResource = getHost();

		else

			onlineResource = status.getOnlineResource();

		symbol = getSymbol(onlineResource);

		req.append(onlineResource).append(symbol).append("REQUEST=GetCapabilities&SERVICE=WMS&");

		req.append("VERSION=").append(getVersion()).append("&EXCEPTIONS=XML");

		return req.toString();

    }  

     public void close() {

        // your code here

    } 

     /**

 	 * @param status

 	 * The WMS status

 	 * @param protocolHandler

 	 * The handler to parse the requests

 	 * @return an object to send the GetMap requests

 	 */

 	protected abstract WMSGetMapRequest createGetMapRequest(WMSStatus status);

 	protected abstract WMSGetFeatureInfoRequest createGetFeatureInfoRequest(WMSStatus status, int x, int y);

 	protected abstract WMSGetLegendGraphicRequest createGetLegendGraphicRequest(WMSStatus status, String layerName);

 	/**

     * <p>Parses the Request tag </p>

     */ 

    protected void parseRequestTag(KXmlParser parser) throws IOException, XmlPullParserException

    {	

    	int currentTag;

    	boolean end = false;

    	parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.REQUEST);

    	currentTag = parser.next();

    	while (!end) 

    	{

			 switch(currentTag)

			 {

				case KXmlParser.START_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.GETCAPABILITIES)==0)

					{

						parserDcpType(parser, CapabilitiesTags.GETCAPABILITIES);

					}	

					else if (parser.getName().compareTo(CapabilitiesTags.GETMAP)==0)

					{	

						parseGetMapTag(parser);						

					}

					else if (parser.getName().compareTo(CapabilitiesTags.GETFEATUREINFO)==0)

					{

						parseGetFeatureInfoTag(parser);

					}		

					else if (parser.getName().compareTo(CapabilitiesTags.DESCRIBELAYER)==0)

					{

						parserDcpType(parser, CapabilitiesTags.DESCRIBELAYER);

					}	

					else if (parser.getName().compareTo(CapabilitiesTags.GETLEGENDGRAPHIC)==0)

					{

						parseGetLegendGraphicTag(parser);

					}					

					break;

				case KXmlParser.END_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.REQUEST) == 0)

						end = true;

					break;

				case KXmlParser.TEXT:					

				break;

			 }

			 if(!end)

				 currentTag = parser.next();

    	}

    	// TODO: does not get such a tag when arrives here!!!!!!

    	//parser.require(KXmlParser.END_TAG, null, CapabilitiesTags.REQUEST);    	

    }   

 	 /**

     * <p>Parses the GetMap tag </p>

     */ 

    protected void parseGetMapTag(KXmlParser parser) throws IOException, XmlPullParserException

    {	

    	int currentTag;

    	boolean end = false;

    	parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.GETMAP);

    	currentTag = parser.next();

    	while (!end) 

    	{

			 switch(currentTag)

			 {

				case KXmlParser.START_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.FORMAT)==0)

					{

						serviceInfo.formats.add(parser.nextText());

					}	

					else if (parser.getName().compareTo(CapabilitiesTags.DCPTYPE)==0)

					{		

						parserDcpType(parser, CapabilitiesTags.GETMAP);						

					}			

					break;

				case KXmlParser.END_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.GETMAP) == 0)

						end = true;

					break;

				case KXmlParser.TEXT:					

				break;

			 }

			 if(!end)

				 currentTag = parser.next();

    	}	

    }    

    /**

     * <p>Parses the GetFeatureInfo tag </p>

     */ 

    protected void parseGetFeatureInfoTag(KXmlParser parser) throws IOException, XmlPullParserException

    {	

    	int currentTag;

    	boolean end = false;

    	parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.GETFEATUREINFO);

    	currentTag = parser.next();

    	while (!end) 

    	{

			 switch(currentTag)

			 {

				case KXmlParser.START_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.FORMAT)==0)

					{

						//TODO:

						// add the supported formats by the GetFeatureInfo request

						//serviceInfo.formats.add(parser.nextText());

					}	

					else if (parser.getName().compareTo(CapabilitiesTags.DCPTYPE)==0)

					{			

						parserDcpType(parser, CapabilitiesTags.GETFEATUREINFO);		

					}			

					break;

				case KXmlParser.END_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.GETFEATUREINFO) == 0)

						end = true;

					break;

				case KXmlParser.TEXT:					

				break;

			 }

			 if(!end)

				 currentTag = parser.next();

    	}	

    }     

    /**

     * <p>Parses the GetLegendGraphic tag </p>

     */ 

    protected void parseGetLegendGraphicTag(KXmlParser parser) throws IOException, XmlPullParserException

    {	

    	int currentTag;

    	boolean end = false;

    	parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.GETLEGENDGRAPHIC);

    	currentTag = parser.next();

    	while (!end) 

    	{

			 switch(currentTag)

			 {

				case KXmlParser.START_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.FORMAT)==0)

					{

						//TODO:

						// add the supported formats by the GetLegendGraphic request

						//serviceInfo.formats.add(parser.nextText());

					}	

					else if (parser.getName().compareTo(CapabilitiesTags.DCPTYPE)==0)

					{			

						parserDcpType(parser, CapabilitiesTags.GETLEGENDGRAPHIC);		

					}			

					break;

				case KXmlParser.END_TAG:

					if (parser.getName().compareTo(CapabilitiesTags.GETLEGENDGRAPHIC) == 0)

						end = true;

					break;

				case KXmlParser.TEXT:					

				break;

			 }

			 if(!end)

				 currentTag = parser.next();

    	}	

    }

 }

/* 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.

 * 

 */

/*

 * AUTHORS (In addition to CIT):

 * 2009 Iver T.I.  {{Task}}

 */

package org.gvsig.remoteclient.wms;

import java.util.Hashtable;

import org.gvsig.remoteclient.ogc.OGCClientOperation;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

/**

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>

 */

public class WMSOperation extends OGCClientOperation{ 

	protected static Hashtable operations = new Hashtable();

	static{

		operations.put(CapabilitiesTags.GETCAPABILITIES, new WMSOperation(CapabilitiesTags.GETCAPABILITIES));

		operations.put(CapabilitiesTags.GETFEATUREINFO, new WMSOperation(CapabilitiesTags.GETFEATUREINFO));

		operations.put(CapabilitiesTags.GETLEGENDGRAPHIC, new WMSOperation(CapabilitiesTags.GETLEGENDGRAPHIC));

		operations.put(CapabilitiesTags.GETMAP, new WMSOperation(CapabilitiesTags.GETMAP));

		operations.put(CapabilitiesTags.DESCRIBELAYER, new WMSOperation(CapabilitiesTags.DESCRIBELAYER));

	}

	public WMSOperation(String operationName) {

		super(operationName);		

	}

	public WMSOperation(String operationName, String onlineResource) {

		super(operationName, onlineResource);		

	}

	/*

	 * (non-Javadoc)

	 * @see org.gvsig.remoteClient.OGCClientOperation#getOperations()

	 */

	public Hashtable getOperations() {

		return operations;

	}

}

package org.gvsig.remoteclient.wms;

import java.io.IOException;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParserException;

/**

 * <p>Defines a OGC style. Theme that describes the appeareance of certain layer.</p>

 *

 */

public abstract class WMSStyle {

	//style name, defined in the WMS capabilities

	private String name;

	//style title, defined in the WMS capabilities

	private String title;

	// style abstract, defined in the WMS capabilities

    private String styleAbstract;

    private org.gvsig.remoteclient.wms.WMSStyle.LegendURL legendURL;

    /**

     * <p>Parses the STYLE tag in the WMS capabilities, filling the WMSStyle object

     * loading the data in memory to be easily accesed</p>

     *

     */

    public abstract void parse(KXmlParser parser) throws IOException, XmlPullParserException;

    /**

     * Parses the legendURL tag.

     * @param parser

     * @throws IOException

     * @throws XmlPullParserException

     */

    protected void parseLegendURL(KXmlParser parser) throws IOException, XmlPullParserException

    {

    	int currentTag;

    	boolean end = false;

    	parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.LEGENDURL);

    	String value = new String();

    	legendURL = new LegendURL();

    	//First of all set whether the layer is Queryable reading the attribute.

    	value = parser.getAttributeValue("", CapabilitiesTags.WIDTH);

    	if (value != null)

    	{

    		legendURL.width = Integer.parseInt( value );

    	}

    	value = parser.getAttributeValue("", CapabilitiesTags.HEIGHT);

    	if (value != null)

    	{

    		legendURL.height = Integer.parseInt( value );

    	}

    	currentTag = parser.nextTag();

    	while (!end)

    	{

    		switch(currentTag)

    		{

    		case KXmlParser.START_TAG:

    			if (parser.getName().compareTo(CapabilitiesTags.FORMAT)==0)

    			{

    				legendURL.format = parser.nextText();

    			}

    			else if (parser.getName().compareTo(CapabilitiesTags.ONLINERESOURCE)==0)

    			{

    				value = parser.getAttributeValue("", CapabilitiesTags.XLINK_TYPE);

    				if (value != null)

    					legendURL.onlineResource_type = value;

    				value = parser.getAttributeValue("", CapabilitiesTags.XLINK_HREF);

    				if (value != null)

    					legendURL.onlineResource_href = value;

    			}

    			break;

    		case KXmlParser.END_TAG:

    			if (parser.getName().compareTo(CapabilitiesTags.LEGENDURL) == 0)

    				end = true;

    			break;

    		case KXmlParser.TEXT:

    			break;

    		}

    		if (!end)

    		{

    			currentTag = parser.next();

    		}

    	}

    	parser.require(KXmlParser.END_TAG, null, CapabilitiesTags.LEGENDURL);

    }

    /**

     * gets the LegendURL OnlineResource type

     */

    public String getLegendURLOnlineResourceType()

    {

    	if (legendURL != null)

    	{

    		return legendURL.onlineResource_type;

    	}

    	else

    	{

    		return null;

    	}

    }

    /**

     * gets the LegendURL OnlineResource href

     */

    public String getLegendURLOnlineResourceHRef()

    {

    	if (legendURL != null)

    	{

    		return legendURL.onlineResource_href;

    	}

    	else

    	{

    		return null;

    	}

    }

    public String getLegendURLFormat()

    {

    	if (legendURL != null)

    	{

    		return legendURL.format;

    	}

    	else

    	{

    		return null;

    	}

    }

    public int getLegendURLWidth()

    {

    	if (legendURL != null)

    	{

    		return legendURL.width;

    	}

    	return 0;

    }

    public int getLegendURLHeight()

    {

    	if (legendURL != null)

    	{

    		return legendURL.height;

    	}

    	return 0;

    }

    /**

     * sets LegendURL

     */

    protected void setLegendURL(LegendURL legendURL)

    {

    	this.legendURL = legendURL;

    }

    /**

     * <p>gets the style name</p>

     *

     * @return style name

     */

    public String getName() {

    	return name;

    }

    /**

     * <p>sets the style name.</p>

     *

     * @param _name

     */

    public void setName(String _name) {

    	name = _name;

    }

    /**

     * <p>gets the style title</p>

     *

     *

     * @return style title

     */

    public String getTitle() {

    	return title;

    }

    /**

     * <p>Sets style title</p>

     *

     *

     * @param _title

     */

    public void setTitle(String _title) {

    	title = _title.trim();

    }

    /**

     * <p>gets style abstract</p>

     *

     *

     * @return style abstract

     */

    public String getAbstract() {

    	return styleAbstract;

    }

    /**

     * <p>sets style abstract</p>

     *

     *

     * @param _abstract, style abstract

     */

    public void setAbstract(String _abstract) {

    	styleAbstract = _abstract;

    }

    /**

     * <p>Inner class describing the Legend URL defined for styles in the OGC specifications in WMS</p>

     *

     */

    protected class LegendURL

    {

    	public LegendURL()

    	{

    		width = 0;

    		height= 0;

    		format = new String();

    		onlineResource_type = new String();

    		onlineResource_href = new String();

    	}

    	public int width;

    	public int height;

    	public String format;

    	public String onlineResource_type;

    	public String onlineResource_href;

    }

}

/* 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.

* 

*/

/*

* AUTHORS (In addition to CIT):

* 2009 Iver T.I.  {{Task}}

*/

package org.gvsig.remoteclient.wms;

import java.util.Vector;

import org.gvsig.remoteclient.ogc.OGCClientOperation;

import org.gvsig.remoteclient.ogc.OGCServiceInformation;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

/**

 * Class that represents the description of the WMS metadata.

 * The first part of the capabilities will return the service information

 * from the WMS, this class will hold this information.

 * 

 * @author <a href="mailto:jpiera@gvsig.org">Jorge Piera</a>

 */

public class WMSServiceInformation extends OGCServiceInformation{

	/*public String map_online_resource = null;

    public String feature_online_resource = null;*/

    public String version;

    public String name;

    public String scope;

    public String title;

    public String abstr;

    public String keywords;

    public String fees;

    public String operationsInfo;

    public String personname;

    public String organization;

    public String function;

    public String addresstype;

    public String address;

    public String place;

    public String province;

    public String postcode;

    public String country;

    public String phone;

    public String fax;

    public String email;

    public Vector formats;

    public WMSServiceInformation()

    {

        version = new String();

        name = new String();

        scope = new String();

        title = new String();

        abstr = new String();

        keywords = new String();

        fees = new String();

        operationsInfo = new String();

        personname = new String();

        organization = new String();

        function = new String();

        addresstype = new String();

        address = new String();

        place = new String();

        province = new String();

        postcode = new String();

        country = new String();

        phone = new String();

        fax = new String();

        email = new String();

        formats = new Vector();       

    }

    public boolean isQueryable()

    {

    	if (getOnlineResource(CapabilitiesTags.GETFEATUREINFO) != null)    	

    		return true;

    	else

    		return false;

    }

    public boolean hasLegendGraphic()

    {

    	if (getOnlineResource(CapabilitiesTags.GETLEGENDGRAPHIC) != null) 

    		return true;

    	else

    		return false;

    }

    public void clear() {

    	version = new String();

        name = new String();

        scope = new String();

        title = new String();

        abstr = new String();

        keywords = new String();

        fees = new String();

        operationsInfo = new String();

        personname = new String();

        organization = new String();

        function = new String();

        addresstype = new String();

        address = new String();

        place = new String();

        province = new String();

        postcode = new String();

        country = new String();

        phone = new String();

        fax = new String();

        email = new String();

        formats = new Vector();        

    }      

	/* (non-Javadoc)

	 * @see org.gvsig.remoteClient.ogc.OGCServiceInformation#createOperation(java.lang.String)

	 */	

	public OGCClientOperation createOperation(String name) {

		return new WMSOperation(name); 

	}

	/* (non-Javadoc)

	 * @see org.gvsig.remoteClient.ogc.OGCServiceInformation#createOperation(java.lang.String, java.lang.String)

	 */	

	public OGCClientOperation createOperation(String name, String onlineResource) {

		return new WMSOperation(name, onlineResource);

	}	

 }

/* gvSIG. Sistema de Informaci?n Geogr?fica de la Generalitat Valenciana

 *

 * Copyright (C) 2005 IVER T.I. and Generalitat Valenciana.

 *

 * 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., 59 Temple Place - Suite 330, Boston, MA  02111-1307,USA.

 *

 * For more information, contact:

 *

 *  Generalitat Valenciana

 *   Conselleria d'Infraestructures i Transport

 *   Av. Blasco Ib??ez, 50

 *   46010 VALENCIA

 *   SPAIN

 *

 *      +34 963862235

 *   gvsig@gva.es

 *      www.gvsig.gva.es

 *

 *    or

 *

 *   IVER T.I. S.A

 *   Salamanca 50

 *   46005 Valencia

 *   Spain

 *

 *   +34 963163400

 *   dac@iver.es

 */

/* CVS MESSAGES:

 *

 * $Id$

 * $Log$

 * Revision 1.1  2006-05-24 16:37:34  jaume

 * *** empty log message ***

 *

 *

 */

package org.gvsig.remoteclient.wms;

/**

 * <p>When a task is accessing to remote data, takes an indeterminate time, and occasionally gets locked. That's

 * the reason a task should support to be cancelable.</p>

 * <p><code>ICancellable</code> interface is designed for getting information about the cancellation of a

 * task of downloading remote information.</p>

 */

public interface ICancellable {

	/**

	 * <p>Returns <code>true</code> if a download or a group of downloads tasks has been canceled.</p>

	 * 

	 * @return <code>true</code> if a download or a group of downloads tasks has been canceled, otherwise <code>false</code>

	 */

	public boolean isCanceled();

	/**

	 * <p>Used to cancel only a group of downloads tasks with the same identifier.</p>

	 * 

	 * @return the identifier

	 */

	public Object getID();

}

package org.gvsig.remoteclient.wms;

import java.io.IOException;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParserException;

public class WMSExtent {

    private String name; 

    /**

     * Indicates that the server will round off inexact dimension values

     * to the nearest valid value, or (if it is null or zero) it will not.

     */

    private String nearestValue; 

    /**

     * Indicates that temporal data are normally kept current and that the

     * request parameter TIME <b>may</b> include the keyword 'current' 

     * instead of an ending value. 

     */

    private String current;

    /**

     * cotains the expression for this dimension's extent.

     */

    private String extentExpression;

    private String extDefaultValue;

    public String getName() {        

        return name;

    } 

    /**

     * Tells that the temporal data are normally kept current and that

     * the request parameter TIME may include the keyword 'current'

     * instead of an ending value.

     *

     * @return <b>true</b> if the server does keep the data, <b>false</b> else.

     */

    public boolean allowsCurrentTime() {

        return (current!=null && !current.equals("0"));

    }

    /**

     * Gets the value that would be used along this dimension if a Web

     * request omits a value for the dimension.

     * 

     * @return Returns the defaultValue.

     */

    public String getDefaultValue() {

        return extDefaultValue;

    }

    /**

     * Returns the extent expression as it was written in the Capabilities 

     * document.

     * @return String

     */

    public String getExtentExpression() {

        return extentExpression;

    }

    /**

     * @return Returns the nearestValues.

     */

    public boolean allowsNearestValue() {

        return (nearestValue!=null && !nearestValue.equals("0"));

    }	 

	   /**

	 * Parses the EXTENT tag in the WMS capabilities, filling the Extend fills of the

	 * WMSDimension object and loading the data into memory to be easily accesed.

	 */

	public void parse(KXmlParser parser) throws IOException, XmlPullParserException{

	    parser.require(KXmlParser.START_TAG, null, CapabilitiesTags.EXTENT);

	    name			 = parser.getAttributeValue("", CapabilitiesTags.DIMENSION_NAME);

	    extDefaultValue  = parser.getAttributeValue("", CapabilitiesTags.DEFAULT);

	    nearestValue    = parser.getAttributeValue("", CapabilitiesTags.EXTENT_NEAREST_VALUE);

	    current          = parser.getAttributeValue("", CapabilitiesTags.EXTENT_CURRENT);

	    extentExpression = parser.nextText();

	}	

}

package org.gvsig.remoteclient.wms;

import java.io.IOException;

import java.util.ArrayList;

import java.util.Hashtable;

import java.util.TreeMap;

import java.util.Vector;

import org.gvsig.remoteclient.utils.BoundaryBox;

import org.gvsig.remoteclient.utils.CapabilitiesTags;

import org.kxml2.io.KXmlParser;

import org.xmlpull.v1.XmlPullParserException;

/**

 * <p>Abstract class that defines an WMSLayer.</p>

 *

 */

public abstract class WMSLayer implements org.gvsig.remoteclient.ILayer {

    protected ArrayList children;

    protected WMSLayer parent;

    /**

     * <p>Layer Abstract field in the capabilities document </p>

     */

    private String layerAbstract;

    /**

     * <p>Themes provided by the WMS for the layer</p>

     */

    public ArrayList styles = new ArrayList();

    /**

     * <p>Layer name</p>

     */

    private String name;

    /**

     * <p>Layer title</p>

     */

    private String title;

    private ArrayList keywordList = new ArrayList();

    /**

     * <p>Layer srs.</p>

     */

    protected Vector srs = new Vector();

    /**

     * <p>extents for each srs the layer can be reproyected to</p>

     */

    private Hashtable bBoxes  = new Hashtable();

    /**

     * <p>extents that defines the bbox for the LatLon projection

     * It can be included in the bBoxes vector as well, because it is the most used, we keep it separeted too, according

     *  with the OGC WMSCapabilities specifications...

     */

    private org.gvsig.remoteclient.utils.BoundaryBox latLonBbox;

    /**

     * <p>min scale for the layer to be visible</p>

     */

    private double scaleMin;

    /**

     * <p>max scale for the layer to be visible</p>

     */

    private double scaleMax;

    /**

     * <p>Dimensions defined for the layer in the capabilities doc</p>

     */

    protected java.util.ArrayList dimensions = new ArrayList();

    /**

     * Tells if this layer accepts getFeatureInfo requests.

     */

    private boolean queryable = false;

    /**

     * Tells if this layer is opaque.

     */

    private boolean opaque = false;

    /**

     * when set to true, noSubsets indicates that the server is not able to make a map

     * of a geographic area other than the layer's bounding box.

     */

    private boolean m_noSubSets = false;

    /**

     * when present and non-zero fixedWidth and fixedHeight indicate that the server is not

     * able to produce a map of the layer at a width and height different from the fixed sizes indicated.

     */

    private int fixedWidth = 0;

    private int fixedHeight = 0;

    /**

     * Tells if this layer can be served with transparency.

     */

    private boolean transparency;

    /**

     * <p>Parses the LAYER tag in the WMS capabilities, filling the WMSLayer object

     * loading the data in memory to be easily accesed</p>

     *

     */

    public abstract void parse(KXmlParser parser, TreeMap layerTreeMap)

    throws IOException, XmlPullParserException;

    //public abstract ArrayList getAllDimensions();

    /**

     * add a new keyword to the keywordList.

     * @param key

     */

    protected void addkeyword(String key)

    {

    	keywordList.add(key);

    }

    public ArrayList getKeywords()

    {

    	return keywordList;

    }

    /**

     * <p>Adds a style to the styles vector</p>

     * @param _style

     */

    public void addStyle(org.gvsig.remoteclient.wms.WMSStyle _style) {

        styles.add( _style );    }

   /**

     * <p>Gets the style vector</p>

     * @return

     */

    public ArrayList getStyles() {

    	ArrayList list = new ArrayList();

    	if (styles != null)

    		list.addAll(styles);

    	if (this.getParent()!= null)

    	{

    		//return getAllStyles(this);

    		if(this.getParent().getStyles() != null)

    			list.addAll(this.getParent().getStyles());

    	}

        return list;

    }

    public ArrayList getAllStyles(WMSLayer layer)

    {

    	if (layer.getParent()!= null)

    	{

    		ArrayList list = getAllStyles(layer.getParent());

    		for(int i = 0; i < this.styles.size(); i++)

    		{

    			list.add(styles.get(i));

    		}

    		return list;

    	}

    	else