Statistics
| Revision:

root / org.gvsig.proj / branches / refactor2018 / org.gvsig.proj / org.gvsig.proj.catalog / org.gvsig.proj.catalog.api / src / main / java / org / gvsig / proj / catalogue / operation / ConcatenatedOperation.java @ 793

History | View | Annotate | Download (4.34 KB)

1
/**
2
 * gvSIG. Desktop Geographic Information System.
3
 *
4
 * Copyright (C) 2018 gvSIG Association.
5
 * 
6
 * This file has been adapted from GeoAPI, see 
7
 * the original copyright headers bellow.
8
 *
9
 * This program is free software; you can redistribute it and/or
10
 * modify it under the terms of the GNU General Public License
11
 * as published by the Free Software Foundation; either version 2
12
 * of the License, or (at your option) any later version.
13
 *
14
 * This program is distributed in the hope that it will be useful,
15
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
16
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
17
 * GNU General Public License for more details.
18
 *
19
 * You should have received a copy of the GNU General Public License
20
 * along with this program; if not, write to the Free Software
21
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
22
 * MA  02110-1301, USA.
23
 *
24
 * For any additional information, do not hesitate to contact us
25
 * at info AT gvsig.com, or visit our website www.gvsig.com.
26
 * 
27
 * ----------
28
 * 
29
 *    GeoAPI - Java interfaces for OGC/ISO standards
30
 *    http://www.geoapi.org
31
 *
32
 *    Copyright (C) 2004-2017 Open Geospatial Consortium, Inc.
33
 *    All Rights Reserved. http://www.opengeospatial.org/ogc/legal
34
 *
35
 *    Permission to use, copy, and modify this software and its documentation, with
36
 *    or without modification, for any purpose and without fee or royalty is hereby
37
 *    granted, provided that you include the following on ALL copies of the software
38
 *    and documentation or portions thereof, including modifications, that you make:
39
 *
40
 *    1. The full text of this NOTICE in a location viewable to users of the
41
 *       redistributed or derivative work.
42
 *    2. Notice of any changes or modifications to the OGC files, including the
43
 *       date changes were made.
44
 *
45
 *    THIS SOFTWARE AND DOCUMENTATION IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE
46
 *    NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
47
 *    TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT
48
 *    THE USE OF THE SOFTWARE OR DOCUMENTATION WILL NOT INFRINGE ANY THIRD PARTY
49
 *    PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.
50
 *
51
 *    COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR
52
 *    CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENTATION.
53
 *
54
 *    The name and trademarks of copyright holders may NOT be used in advertising or
55
 *    publicity pertaining to the software without specific, written prior permission.
56
 *    Title to copyright in this software and any associated documentation will at all
57
 *    times remain with copyright holders.
58
 */
59
package org.gvsig.proj.catalogue.operation;
60

    
61
import java.util.List;
62

    
63
import org.gvsig.proj.catalogue.CoordinateOperationDefinition;
64

    
65
/**
66
 * An ordered sequence of two or more single coordinate operations. The sequence of operations is
67
 * constrained by the requirement that the source coordinate reference system of step
68
 * (<var>n</var>+1) must be the same as the target coordinate reference system of step
69
 * (<var>n</var>). The source coordinate reference system of the first step and the target
70
 * coordinate reference system of the last step are the source and target coordinate reference
71
 * system associated with the concatenated operation. Instead of a forward operation, an inverse
72
 * operation may be used for one or more of the operation steps mentioned above, if the inverse
73
 * operation is uniquely defined by the forward operation.
74
 * 
75
 * Note: gvSIG derived these interfaces from GeoAPI in order to have a simpler API and also to
76
 * avoid namespace collisions (e.g. GeoAPI 3 vs GeoTools interfaces). There is no plans
77
 * to evolve these interfaces to adapt them to future GeoAPI versions.
78
 * 
79
 * @author  gvSIG Team
80
 * @author  Martin Desruisseaux (IRD)
81
 * @version 4.0
82
 * @since   1.0
83
 *
84
 * @see CoordinateOperationFactory#createConcatenatedOperation(Map, CoordinateOperation[])
85
 */
86
public interface ConcatenatedOperation extends CoordinateOperationDefinition {
87

    
88
    /**
89
     * Returns the sequence of operations.
90
     * The sequence can contain {@link SingleOperation}s or {@link PassThroughOperation}s,
91
     * but should not contain other {@code ConcatenatedOperation}s.
92
     *
93
     * @return the sequence of operations.
94
     */
95
        List<? extends CoordinateOperationDefinition> getOperations();
96
}