Skip to content
Snippets Groups Projects
Commit 739eeec9 authored by gmantele's avatar gmantele
Browse files

[TAP] Fix the XML serialization for 'foreignKey' items in /tables. 

The order of its children was incorrect according to the XSD schema:
the 'fkColumn' must be written before 'description' and 'utype'.
parent 239c7178
No related branches found
No related tags found
No related merge requests found
Hide whitespace changes
Inline Side-by-side
src/tap/metadata/TAPMetadata.java
+ 110
− 109
View file @ 739eeec9
...@@ -2,20 +2,20 @@ package tap.metadata; ...@@ -2,20 +2,20 @@ package tap.metadata;
/* /*
* This file is part of TAPLibrary. * This file is part of TAPLibrary.
* *
* TAPLibrary is free software: you can redistribute it and/or modify * TAPLibrary is free software: you can redistribute it and/or modify
* it under the terms of the GNU Lesser General Public License as published by * it under the terms of the GNU Lesser General Public License as published by
* the Free Software Foundation, either version 3 of the License, or * the Free Software Foundation, either version 3 of the License, or
* (at your option) any later version. * (at your option) any later version.
* *
* TAPLibrary is distributed in the hope that it will be useful, * TAPLibrary is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of * but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU Lesser General Public License for more details. * GNU Lesser General Public License for more details.
* *
* You should have received a copy of the GNU Lesser General Public License * You should have received a copy of the GNU Lesser General Public License
* along with TAPLibrary. If not, see <http://www.gnu.org/licenses/>. * along with TAPLibrary. If not, see <http://www.gnu.org/licenses/>.
* *
* Copyright 2012-2017 - UDS/Centre de Données astronomiques de Strasbourg (CDS), * Copyright 2012-2017 - UDS/Centre de Données astronomiques de Strasbourg (CDS),
* Astronomisches Rechen Institut (ARI) * Astronomisches Rechen Institut (ARI)
*/ */
...@@ -50,14 +50,14 @@ import uws.UWSToolBox; ...@@ -50,14 +50,14 @@ import uws.UWSToolBox;
/** /**
* <p>Let listing all schemas, tables and columns available in a TAP service. * <p>Let listing all schemas, tables and columns available in a TAP service.
* This list also corresponds to the TAP resource "/tables".</p> * This list also corresponds to the TAP resource "/tables".</p>
* *
* <p> * <p>
* Only schemas are stored in this object. So that's why only schemas can be * Only schemas are stored in this object. So that's why only schemas can be
* added and removed from this class. However, {@link TAPSchema} objects are * added and removed from this class. However, {@link TAPSchema} objects are
* listing tables, whose the object representation is listing columns. So to * listing tables, whose the object representation is listing columns. So to
* add tables, you must first embed them in a schema. * add tables, you must first embed them in a schema.
* </p> * </p>
* *
* <p> * <p>
* All metadata have two names: one to use in ADQL queries and the other to use * All metadata have two names: one to use in ADQL queries and the other to use
* when really querying the database. This is very useful to hide the real * when really querying the database. This is very useful to hide the real
...@@ -67,16 +67,16 @@ import uws.UWSToolBox; ...@@ -67,16 +67,16 @@ import uws.UWSToolBox;
* point of view. In a such case, the schema would have an ADQL name but no DB * point of view. In a such case, the schema would have an ADQL name but no DB
* name (NULL value ; which is possible only with {@link TAPSchema} objects). * name (NULL value ; which is possible only with {@link TAPSchema} objects).
* </p> * </p>
* *
* <p> * <p>
* This class lets also detect the ObsCore and RegTAP data models, thanks to * This class lets also detect the ObsCore and RegTAP data models, thanks to
* the functions {@link #getObsCoreTable()} and {@link #getRegTAPSchema()} * the functions {@link #getObsCoreTable()} and {@link #getRegTAPSchema()}
* which return resp. the ObsCore table and the RegTAP schema if matching the * which return resp. the ObsCore table and the RegTAP schema if matching the
* IVOA specification. * IVOA specification.
* </p> * </p>
* *
* @author Gr&eacute;gory Mantelet (CDS;ARI) * @author Gr&eacute;gory Mantelet (CDS;ARI)
* @version 2.1 (09/2017) * @version 2.1 (11/2017)
*/ */
public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResource { public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResource {
...@@ -101,7 +101,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -101,7 +101,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Build an empty list of metadata.</p> * <p>Build an empty list of metadata.</p>
* *
* <p><i>Note: * <p><i>Note:
* By default, a TAP service must have at least a TAP_SCHEMA schema which contains a set of 5 tables * By default, a TAP service must have at least a TAP_SCHEMA schema which contains a set of 5 tables
* (schemas, tables, columns, keys and key_columns). This schema is not created here by default * (schemas, tables, columns, keys and key_columns). This schema is not created here by default
...@@ -128,9 +128,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -128,9 +128,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Gets the path/URL of the XSLT style-sheet to use. * Gets the path/URL of the XSLT style-sheet to use.
* *
* @return XSLT path/url. * @return XSLT path/url.
* *
* @version 2.1 * @version 2.1
*/ */
public final String getXSLTPath(){ public final String getXSLTPath(){
...@@ -139,9 +139,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -139,9 +139,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Sets the path/URL of the XSLT style-sheet to use. * Sets the path/URL of the XSLT style-sheet to use.
* *
* @param path The new XSLT path/URL. * @param path The new XSLT path/URL.
* *
* @version 2.1 * @version 2.1
*/ */
public final void setXSLTPath(final String path){ public final void setXSLTPath(final String path){
...@@ -156,11 +156,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -156,11 +156,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Add the given schema inside this TAP metadata set.</p> * <p>Add the given schema inside this TAP metadata set.</p>
* *
* <p><i>Note: * <p><i>Note:
* If the given schema is NULL, nothing will be done. * If the given schema is NULL, nothing will be done.
* </i></p> * </i></p>
* *
* @param s The schema to add. * @param s The schema to add.
*/ */
public final void addSchema(TAPSchema s){ public final void addSchema(TAPSchema s){
...@@ -171,16 +171,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -171,16 +171,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Build a new {@link TAPSchema} object with the given ADQL name. * <p>Build a new {@link TAPSchema} object with the given ADQL name.
* Then, add it inside this TAP metadata set.</p> * Then, add it inside this TAP metadata set.</p>
* *
* <p><i>Note: * <p><i>Note:
* The built {@link TAPSchema} object is returned, so that being modified afterwards if needed. * The built {@link TAPSchema} object is returned, so that being modified afterwards if needed.
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema to create and add inside this TAP metadata set. * @param schemaName ADQL name of the schema to create and add inside this TAP metadata set.
* *
* @return The created and added schema, * @return The created and added schema,
* or NULL if the given schema is NULL or an empty string. * or NULL if the given schema is NULL or an empty string.
* *
* @see TAPSchema#TAPSchema(String) * @see TAPSchema#TAPSchema(String)
* @see #addSchema(TAPSchema) * @see #addSchema(TAPSchema)
*/ */
...@@ -196,18 +196,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -196,18 +196,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Build a new {@link TAPSchema} object with the given ADQL name. * <p>Build a new {@link TAPSchema} object with the given ADQL name.
* Then, add it inside this TAP metadata set.</p> * Then, add it inside this TAP metadata set.</p>
* *
* <p><i>Note: * <p><i>Note:
* The built {@link TAPSchema} object is returned, so that being modified afterwards if needed. * The built {@link TAPSchema} object is returned, so that being modified afterwards if needed.
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema to create and add inside this TAP metadata set. * @param schemaName ADQL name of the schema to create and add inside this TAP metadata set.
* @param description Description of the new schema. <i>MAY be NULL</i> * @param description Description of the new schema. <i>MAY be NULL</i>
* @param utype UType associating the new schema with a data-model. <i>MAY be NULL</i> * @param utype UType associating the new schema with a data-model. <i>MAY be NULL</i>
* *
* @return The created and added schema, * @return The created and added schema,
* or NULL if the given schema is NULL or an empty string. * or NULL if the given schema is NULL or an empty string.
* *
* @see TAPSchema#TAPSchema(String, String, String) * @see TAPSchema#TAPSchema(String, String, String)
* @see #addSchema(TAPSchema) * @see #addSchema(TAPSchema)
*/ */
...@@ -222,13 +222,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -222,13 +222,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Tell whether there is a schema with the given ADQL name.</p> * <p>Tell whether there is a schema with the given ADQL name.</p>
* *
* <p><i><b>Important note:</b> * <p><i><b>Important note:</b>
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema whose the existence must be checked. * @param schemaName ADQL name of the schema whose the existence must be checked.
* *
* @return <i>true</i> if a schema with the given ADQL name exists, <i>false</i> otherwise. * @return <i>true</i> if a schema with the given ADQL name exists, <i>false</i> otherwise.
*/ */
public final boolean hasSchema(String schemaName){ public final boolean hasSchema(String schemaName){
...@@ -240,13 +240,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -240,13 +240,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Search for a schema having the given ADQL name.</p> * <p>Search for a schema having the given ADQL name.</p>
* *
* <p><i><b>Important note:</b> * <p><i><b>Important note:</b>
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema to search. * @param schemaName ADQL name of the schema to search.
* *
* @return The schema having the given ADQL name, * @return The schema having the given ADQL name,
* or NULL if no such schema can be found. * or NULL if no such schema can be found.
*/ */
...@@ -259,7 +259,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -259,7 +259,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the number of schemas contained in this TAP metadata set. * Get the number of schemas contained in this TAP metadata set.
* *
* @return Number of all schemas. * @return Number of all schemas.
*/ */
public final int getNbSchemas(){ public final int getNbSchemas(){
...@@ -268,7 +268,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -268,7 +268,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Tell whether this TAP metadata set contains no schema. * Tell whether this TAP metadata set contains no schema.
* *
* @return <i>true</i> if this TAP metadata set has no schema, * @return <i>true</i> if this TAP metadata set has no schema,
* <i>false</i> if it contains at least one schema. * <i>false</i> if it contains at least one schema.
*/ */
...@@ -278,20 +278,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -278,20 +278,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Remove the schema having the given ADQL name.</p> * <p>Remove the schema having the given ADQL name.</p>
* *
* <p><i><b>Important note:</b> * <p><i><b>Important note:</b>
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* <p><i><b>WARNING:</b> * <p><i><b>WARNING:</b>
* If the goal of this function's call is to delete definitely the specified schema * If the goal of this function's call is to delete definitely the specified schema
* from the metadata, you SHOULD also call {@link TAPTable#removeAllForeignKeys()} on the * from the metadata, you SHOULD also call {@link TAPTable#removeAllForeignKeys()} on the
* removed table. Indeed, foreign keys of this table would still link the removed table * removed table. Indeed, foreign keys of this table would still link the removed table
* with other tables AND columns of the whole metadata set. * with other tables AND columns of the whole metadata set.
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema to remove from this TAP metadata set. * @param schemaName ADQL name of the schema to remove from this TAP metadata set.
* *
* @return The removed schema, * @return The removed schema,
* or NULL if no such schema can be found. * or NULL if no such schema can be found.
*/ */
...@@ -316,7 +316,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -316,7 +316,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the list of all tables available in this TAP metadata set. * Get the list of all tables available in this TAP metadata set.
* *
* @return An iterator over the list of all tables contained in this TAP metadata set. * @return An iterator over the list of all tables contained in this TAP metadata set.
*/ */
public Iterator<TAPTable> getTables(){ public Iterator<TAPTable> getTables(){
...@@ -325,14 +325,14 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -325,14 +325,14 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Tell whether this TAP metadata set contains the specified table.</p> * <p>Tell whether this TAP metadata set contains the specified table.</p>
* *
* <p><i>Note: * <p><i>Note:
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema owning the table to search. * @param schemaName ADQL name of the schema owning the table to search.
* @param tableName ADQL name of the table to search. * @param tableName ADQL name of the table to search.
* *
* @return <i>true</i> if the specified table exists, <i>false</i> otherwise. * @return <i>true</i> if the specified table exists, <i>false</i> otherwise.
*/ */
public boolean hasTable(String schemaName, String tableName){ public boolean hasTable(String schemaName, String tableName){
...@@ -345,13 +345,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -345,13 +345,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Tell whether this TAP metadata set contains a table with the given ADQL name, whatever is its schema.</p> * <p>Tell whether this TAP metadata set contains a table with the given ADQL name, whatever is its schema.</p>
* *
* <p><i>Note: * <p><i>Note:
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param tableName ADQL name of the table to search. * @param tableName ADQL name of the table to search.
* *
* @return <i>true</i> if the specified table exists, <i>false</i> otherwise. * @return <i>true</i> if the specified table exists, <i>false</i> otherwise.
*/ */
public boolean hasTable(String tableName){ public boolean hasTable(String tableName){
...@@ -363,14 +363,14 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -363,14 +363,14 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Search for the specified table in this TAP metadata set.</p> * <p>Search for the specified table in this TAP metadata set.</p>
* *
* <p><i>Note: * <p><i>Note:
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param schemaName ADQL name of the schema owning the table to search. * @param schemaName ADQL name of the schema owning the table to search.
* @param tableName ADQL name of the table to search. * @param tableName ADQL name of the table to search.
* *
* @return The table which has the given ADQL name and which is inside the specified schema, * @return The table which has the given ADQL name and which is inside the specified schema,
* or NULL if no such table can be found. * or NULL if no such table can be found.
*/ */
...@@ -385,13 +385,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -385,13 +385,13 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Search in this TAP metadata set for all tables whose the ADQL name matches the given one, * <p>Search in this TAP metadata set for all tables whose the ADQL name matches the given one,
* whatever is their schema.</p> * whatever is their schema.</p>
* *
* <p><i>Note: * <p><i>Note:
* This function is case sensitive! * This function is case sensitive!
* </i></p> * </i></p>
* *
* @param tableName ADQL name of the tables to search. * @param tableName ADQL name of the tables to search.
* *
* @return A list of all the tables which have the given ADQL name, * @return A list of all the tables which have the given ADQL name,
* or an empty list if no such table can be found. * or an empty list if no such table can be found.
*/ */
...@@ -405,18 +405,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -405,18 +405,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the description of the ObsCore table, if it is defined. * Get the description of the ObsCore table, if it is defined.
* *
* <p> * <p>
* This function is case sensitive only on the schema name * This function is case sensitive only on the schema name
* (i.e. <code>ivoa</code>) which must be defined in full lower case. * (i.e. <code>ivoa</code>) which must be defined in full lower case.
* The table name (i.e. <code>ObsCore</code>) will be found whatever * The table name (i.e. <code>ObsCore</code>) will be found whatever
* the case it is written in and whether it is prefixed or not. * the case it is written in and whether it is prefixed or not.
* </p> * </p>
* *
* @return Description of the ObsCore table, * @return Description of the ObsCore table,
* or <code>NULL</code> if this table is not provided by this TAP * or <code>NULL</code> if this table is not provided by this TAP
* service. * service.
* *
* @since 2.1 * @since 2.1
*/ */
public TAPTable getObsCoreTable(){ public TAPTable getObsCoreTable(){
...@@ -432,7 +432,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -432,7 +432,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the description of the RegTAP schema, if it is defined. * Get the description of the RegTAP schema, if it is defined.
* *
* <p> * <p>
* This function is case sensitive only on the schema name * This function is case sensitive only on the schema name
* (i.e. <code>rr</code>) which must be defined in full lower case. * (i.e. <code>rr</code>) which must be defined in full lower case.
...@@ -440,11 +440,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -440,11 +440,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
* sensitively as well. However, it does not matter if the table name is * sensitively as well. However, it does not matter if the table name is
* prefixed or not. * prefixed or not.
* </p> * </p>
* *
* @return Description of the RegTAP schema, * @return Description of the RegTAP schema,
* or <code>NULL</code> if RegTAP is not supported in this TAP * or <code>NULL</code> if RegTAP is not supported in this TAP
* service. * service.
* *
* @since 2.1 * @since 2.1
*/ */
public TAPSchema getRegTAPSchema(){ public TAPSchema getRegTAPSchema(){
...@@ -470,7 +470,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -470,7 +470,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the number of all tables contained in this TAP metadata set. * Get the number of all tables contained in this TAP metadata set.
* *
* @return Number of all its tables. * @return Number of all its tables.
*/ */
public int getNbTables(){ public int getNbTables(){
...@@ -482,12 +482,12 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -482,12 +482,12 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the coordinate system definition associated with the given ID. * Get the coordinate system definition associated with the given ID.
* *
* @param coosysId ID of the coordinate system to get. <i>(case sensitive)</i> * @param coosysId ID of the coordinate system to get. <i>(case sensitive)</i>
* *
* @return The corresponding coordinate system definition, * @return The corresponding coordinate system definition,
* or NULL if no match for the given ID. * or NULL if no match for the given ID.
* *
* @since 2.1 * @since 2.1
*/ */
public TAPCoosys getCoosys(final String coosysId){ public TAPCoosys getCoosys(final String coosysId){
...@@ -496,18 +496,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -496,18 +496,18 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Add the given coordinate system definition. * Add the given coordinate system definition.
* *
* <p><b>Important:</b> * <p><b>Important:</b>
* If a coordinate system with the same ID (case sensitive) is already declared in * If a coordinate system with the same ID (case sensitive) is already declared in
* this {@link TAPMetadata}, it will be replaced by the given one. The replaced * this {@link TAPMetadata}, it will be replaced by the given one. The replaced
* coordinate system is returned by this function. * coordinate system is returned by this function.
* </p> * </p>
* *
* @param newCoosys The coordinate system definition to add. * @param newCoosys The coordinate system definition to add.
* *
* @return The coordinate system definition previously declared with the same ID in this {@link TAPMetadata}, * @return The coordinate system definition previously declared with the same ID in this {@link TAPMetadata},
* or NULL if no coord. sys. was declared with this ID. * or NULL if no coord. sys. was declared with this ID.
* *
* @since 2.1 * @since 2.1
*/ */
public TAPCoosys addCoosys(final TAPCoosys newCoosys){ public TAPCoosys addCoosys(final TAPCoosys newCoosys){
...@@ -522,12 +522,12 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -522,12 +522,12 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Remove the coordinate system declared with the given ID. * Remove the coordinate system declared with the given ID.
* *
* @param coosysId The ID of the coordinate system definition to remove. * @param coosysId The ID of the coordinate system definition to remove.
* *
* @return The removed coordinate system definition, * @return The removed coordinate system definition,
* or NULL if none is declared with the given ID. * or NULL if none is declared with the given ID.
* *
* @since 2.1 * @since 2.1
*/ */
public TAPCoosys removeCoosys(final String coosysId){ public TAPCoosys removeCoosys(final String coosysId){
...@@ -536,7 +536,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -536,7 +536,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Let iterating over the list of all tables contained in a given {@link TAPMetadata} object. * Let iterating over the list of all tables contained in a given {@link TAPMetadata} object.
* *
* @author Gr&eacute;gory Mantelet (CDS;ARI) * @author Gr&eacute;gory Mantelet (CDS;ARI)
* @version 2.0 (08/2014) * @version 2.0 (08/2014)
*/ */
...@@ -634,11 +634,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -634,11 +634,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Format in XML this whole metadata set and write it in the given writer. * Format in XML this whole metadata set and write it in the given writer.
* *
* @param writer Stream in which the XML representation of this metadata must be written. * @param writer Stream in which the XML representation of this metadata must be written.
* *
* @throws IOException If there is any error while writing the XML in the given writer. * @throws IOException If there is any error while writing the XML in the given writer.
* *
* @since 2.0 * @since 2.0
*/ */
public void write(final PrintWriter writer) throws IOException{ public void write(final PrintWriter writer) throws IOException{
...@@ -665,7 +665,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -665,7 +665,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Format in XML the given schema and then write it in the given writer.</p> * <p>Format in XML the given schema and then write it in the given writer.</p>
* *
* <p>Written lines:</p> * <p>Written lines:</p>
* <pre> * <pre>
* &lt;schema&gt; * &lt;schema&gt;
...@@ -676,16 +676,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -676,16 +676,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
* // call #writeTable(TAPTable, PrintWriter) for each table * // call #writeTable(TAPTable, PrintWriter) for each table
* &lt;/schema&gt; * &lt;/schema&gt;
* </pre> * </pre>
* *
* <p><i>Note: * <p><i>Note:
* When NULL an attribute or a field is not written. Here this rule concerns: description and utype. * When NULL an attribute or a field is not written. Here this rule concerns: description and utype.
* </i></p> * </i></p>
* *
* @param s The schema to format and to write in XML. * @param s The schema to format and to write in XML.
* @param writer Output in which the XML serialization of the given schema must be written. * @param writer Output in which the XML serialization of the given schema must be written.
* *
* @throws IOException If the connection with the HTTP client has been either canceled or closed for another reason. * @throws IOException If the connection with the HTTP client has been either canceled or closed for another reason.
* *
* @see #writeTable(TAPTable, PrintWriter) * @see #writeTable(TAPTable, PrintWriter)
*/ */
protected void writeSchema(TAPSchema s, PrintWriter writer) throws IOException{ protected void writeSchema(TAPSchema s, PrintWriter writer) throws IOException{
...@@ -723,7 +723,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -723,7 +723,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Format in XML the given table and then write it in the given writer.</p> * <p>Format in XML the given table and then write it in the given writer.</p>
* *
* <p>Written lines:</p> * <p>Written lines:</p>
* <pre> * <pre>
* &lt;table type="..."&gt; * &lt;table type="..."&gt;
...@@ -735,20 +735,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -735,20 +735,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
* // call #writeForeignKey(TAPForeignKey, PrintWriter) for each foreign key * // call #writeForeignKey(TAPForeignKey, PrintWriter) for each foreign key
* &lt;/table&gt; * &lt;/table&gt;
* </pre> * </pre>
* *
* <p><i>Note 1: * <p><i>Note 1:
* When NULL an attribute or a field is not written. Here this rule concerns: description and utype. * When NULL an attribute or a field is not written. Here this rule concerns: description and utype.
* </i></p> * </i></p>
* *
* <p><i>Note 2: * <p><i>Note 2:
* The PrintWriter buffer is flushed all the 10 columns. At that moment the writer is checked for errors. * The PrintWriter buffer is flushed all the 10 columns. At that moment the writer is checked for errors.
* If the error flag is set, a {@link ClientAbortException} is thrown in order to stop the metadata writing. * If the error flag is set, a {@link ClientAbortException} is thrown in order to stop the metadata writing.
* This is particularly useful if the metadata data is pretty large. * This is particularly useful if the metadata data is pretty large.
* </i></p> * </i></p>
* *
* @param t The table to format and to write in XML. * @param t The table to format and to write in XML.
* @param writer Output in which the XML serialization of the given table must be written. * @param writer Output in which the XML serialization of the given table must be written.
* *
* @return The total number of written columns. * @return The total number of written columns.
*/ */
protected int writeTable(TAPTable t, PrintWriter writer){ protected int writeTable(TAPTable t, PrintWriter writer){
...@@ -784,7 +784,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -784,7 +784,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Format in XML the given column and then write it in the given writer.</p> * <p>Format in XML the given column and then write it in the given writer.</p>
* *
* <p>Written lines:</p> * <p>Written lines:</p>
* <pre> * <pre>
* &lt;column std="true|false"&gt; // the value of this field is TAPColumn#isStd() * &lt;column std="true|false"&gt; // the value of this field is TAPColumn#isStd()
...@@ -798,11 +798,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -798,11 +798,11 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
* &lt;flag&gt;primary&lt;/flag&gt; // if TAPColumn#isPrincipal() * &lt;flag&gt;primary&lt;/flag&gt; // if TAPColumn#isPrincipal()
* &lt;/column&gt; * &lt;/column&gt;
* </pre> * </pre>
* *
* <p><i>Note: * <p><i>Note:
* When NULL an attribute or a field is not written. Here this rule concerns: description, unit, utype, ucd and flags. * When NULL an attribute or a field is not written. Here this rule concerns: description, unit, utype, ucd and flags.
* </i></p> * </i></p>
* *
* @param c The column to format and to write in XML. * @param c The column to format and to write in XML.
* @param writer Output in which the XML serialization of the given column must be written. * @param writer Output in which the XML serialization of the given column must be written.
*/ */
...@@ -845,25 +845,25 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -845,25 +845,25 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Format in XML the given foreign key and then write it in the given writer.</p> * <p>Format in XML the given foreign key and then write it in the given writer.</p>
* *
* <p>Written lines:</p> * <p>Written lines:</p>
* <pre> * <pre>
* &lt;foreignKey&gt; * &lt;foreignKey&gt;
* &lt;targetTable&gt;...&lt;/targetTable&gt; * &lt;targetTable&gt;...&lt;/targetTable&gt;
* &lt;description&gt;...&lt;/description&gt;
* &lt;utype&gt;...&lt;/utype&gt;
* &lt;fkColumn&gt; * &lt;fkColumn&gt;
* &lt;fromColumn&gt;...&lt;/fromColumn&gt; * &lt;fromColumn&gt;...&lt;/fromColumn&gt;
* &lt;targetColumn&gt;...&lt;/targetColumn&gt; * &lt;targetColumn&gt;...&lt;/targetColumn&gt;
* &lt;/fkColumn&gt; * &lt;/fkColumn&gt;
* ... * ...
* &lt;description&gt;...&lt;/description&gt;
* &lt;utype&gt;...&lt;/utype&gt;
* &lt;/foreignKey&gt; * &lt;/foreignKey&gt;
* </pre> * </pre>
* *
* <p><i>Note: * <p><i>Note:
* When NULL an attribute or a field is not written. Here this rule concerns: description and utype. * When NULL an attribute or a field is not written. Here this rule concerns: description and utype.
* </i></p> * </i></p>
* *
* @param fk The foreign key to format and to write in XML. * @param fk The foreign key to format and to write in XML.
* @param writer Output in which the XML serialization of the given foreign key must be written. * @param writer Output in which the XML serialization of the given foreign key must be written.
*/ */
...@@ -873,8 +873,6 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -873,8 +873,6 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
writer.println("\t\t\t<foreignKey>"); writer.println("\t\t\t<foreignKey>");
writeAtt(prefix, "targetTable", fk.getTargetTable().getRawName(), false, writer); writeAtt(prefix, "targetTable", fk.getTargetTable().getRawName(), false, writer);
writeAtt(prefix, "description", fk.getDescription(), true, writer);
writeAtt(prefix, "utype", fk.getUtype(), true, writer);
final String prefix2 = prefix + "\t"; final String prefix2 = prefix + "\t";
for(Map.Entry<String,String> entry : fk){ for(Map.Entry<String,String> entry : fk){
...@@ -886,12 +884,15 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -886,12 +884,15 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
writer.println("</fkColumn>"); writer.println("</fkColumn>");
} }
writeAtt(prefix, "description", fk.getDescription(), true, writer);
writeAtt(prefix, "utype", fk.getUtype(), true, writer);
writer.println("\t\t\t</foreignKey>"); writer.println("\t\t\t</foreignKey>");
} }
/** /**
* Write the specified metadata attribute as a simple XML node. * Write the specified metadata attribute as a simple XML node.
* *
* @param prefix Prefix of the XML node. (generally, space characters) * @param prefix Prefix of the XML node. (generally, space characters)
* @param attributeName Name of the metadata attribute to write (= Name of the XML node). * @param attributeName Name of the metadata attribute to write (= Name of the XML node).
* @param attributeValue Value of the metadata attribute (= Value of the XML node). * @param attributeValue Value of the metadata attribute (= Value of the XML node).
...@@ -913,19 +914,19 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -913,19 +914,19 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
* Get the definition of the whole standard TAP_SCHEMA. Thus, all standard TAP_SCHEMA tables * Get the definition of the whole standard TAP_SCHEMA. Thus, all standard TAP_SCHEMA tables
* (with all their columns) are also included in this object. * (with all their columns) are also included in this object.
* </p> * </p>
* *
* <p><i>Note: * <p><i>Note:
* This function create the {@link TAPSchema} and all its {@link TAPTable}s objects on the fly. * This function create the {@link TAPSchema} and all its {@link TAPTable}s objects on the fly.
* </p> * </p>
* *
* @param isSchemaSupported <i>false</i> if the DB name must be prefixed by "TAP_SCHEMA_", <i>true</i> otherwise. * @param isSchemaSupported <i>false</i> if the DB name must be prefixed by "TAP_SCHEMA_", <i>true</i> otherwise.
* *
* @return The whole TAP_SCHEMA definition. * @return The whole TAP_SCHEMA definition.
* *
* @see STDSchema#TAPSCHEMA * @see STDSchema#TAPSCHEMA
* @see STDTable * @see STDTable
* @see #getStdTable(STDTable) * @see #getStdTable(STDTable)
* *
* @since 2.0 * @since 2.0
*/ */
public static final TAPSchema getStdSchema(final boolean isSchemaSupported){ public static final TAPSchema getStdSchema(final boolean isSchemaSupported){
...@@ -944,9 +945,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -944,9 +945,9 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Get the minimum definition of the table TAP_SCHEMA.coosys as expected by * Get the minimum definition of the table TAP_SCHEMA.coosys as expected by
* the library (see {@link tap.db.JDBCConnection#getTAPSchema()}. * the library (see {@link tap.db.JDBCConnection#getTAPSchema()}.
* *
* @return The created definition of TAP_SCHEMA.coosys. * @return The created definition of TAP_SCHEMA.coosys.
* *
* @since 2.1 * @since 2.1
*/ */
public static final TAPTable getCoosysTable(){ public static final TAPTable getCoosysTable(){
...@@ -960,20 +961,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -960,20 +961,20 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Get the definition of the specified standard TAP table.</p> * <p>Get the definition of the specified standard TAP table.</p>
* *
* <p><i><b>Important note:</b> * <p><i><b>Important note:</b>
* The returned table is not linked at all with a schema, on the contrary of {@link #getStdSchema(boolean)} which returns tables linked with the returned schema. * The returned table is not linked at all with a schema, on the contrary of {@link #getStdSchema(boolean)} which returns tables linked with the returned schema.
* So, you may have to linked this table to schema (by using {@link TAPSchema#addTable(TAPTable)}) whose the ADQL name is TAP_SCHEMA after calling this function. * So, you may have to linked this table to schema (by using {@link TAPSchema#addTable(TAPTable)}) whose the ADQL name is TAP_SCHEMA after calling this function.
* </i></p> * </i></p>
* *
* <p><i>Note: * <p><i>Note:
* This function create the {@link TAPTable} object on the fly. * This function create the {@link TAPTable} object on the fly.
* </p> * </p>
* *
* @param tableId ID of the TAP table to return. * @param tableId ID of the TAP table to return.
* *
* @return The corresponding table definition (with no schema). * @return The corresponding table definition (with no schema).
* *
* @since 2.0 * @since 2.0
*/ */
public static final TAPTable getStdTable(final STDTable tableId){ public static final TAPTable getStdTable(final STDTable tableId){
...@@ -1037,16 +1038,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -1037,16 +1038,16 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* <p>Tell whether the given table name is a standard TAP table.</p> * <p>Tell whether the given table name is a standard TAP table.</p>
* *
* <p><i>Note: * <p><i>Note:
* This function is case sensitive. Indeed TAP_SCHEMA tables are defined by the TAP standard by a given case. * This function is case sensitive. Indeed TAP_SCHEMA tables are defined by the TAP standard by a given case.
* Thus, this case is expected here. * Thus, this case is expected here.
* </i></p> * </i></p>
* *
* @param tableName Unqualified table name. * @param tableName Unqualified table name.
* *
* @return The corresponding {@link STDTable} or NULL if the given table is not part of the TAP standard. * @return The corresponding {@link STDTable} or NULL if the given table is not part of the TAP standard.
* *
* @since 2.0 * @since 2.0
*/ */
public static final STDTable resolveStdTable(String tableName){ public static final STDTable resolveStdTable(String tableName){
...@@ -1063,7 +1064,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -1063,7 +1064,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Enumeration of all schemas defined in the TAP standard. * Enumeration of all schemas defined in the TAP standard.
* *
* @author Gr&eacute;gory Mantelet (ARI) * @author Gr&eacute;gory Mantelet (ARI)
* @version 2.0 (07/2014) * @version 2.0 (07/2014)
* @since 2.0 * @since 2.0
...@@ -1086,7 +1087,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour ...@@ -1086,7 +1087,7 @@ public class TAPMetadata implements Iterable<TAPSchema>, VOSIResource, TAPResour
/** /**
* Enumeration of all tables of TAP_SCHEMA. * Enumeration of all tables of TAP_SCHEMA.
* *
* @author Gr&eacute;gory Mantelet (ARI) * @author Gr&eacute;gory Mantelet (ARI)
* @version 2.1 (09/2017) * @version 2.1 (09/2017)
* @since 2.0 * @since 2.0
......
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment