Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/AbstractIdentification.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/AbstractIdentification.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/AbstractIdentification.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/AbstractIdentification.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -71,6 +71,7 @@ import static org.opengis.annotation.Spe * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "AbstractMD_Identification_Type", propOrder = { "citation", "abstract", @@ -205,8 +206,8 @@ public class AbstractIdentification exte /** * Creates an identification initialized to the specified values. * - * @param citation The citation data for the resource(s), or {@code null} if none. - * @param abstracts A brief narrative summary of the content of the resource(s), or {@code null} if none. + * @param citation the citation data for the resource(s), or {@code null} if none. + * @param abstracts a brief narrative summary of the content of the resource(s), or {@code null} if none. */ public AbstractIdentification(final Citation citation, final CharSequence abstracts) { this.citation = citation; @@ -218,7 +219,7 @@ public class AbstractIdentification exte * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(Identification) */ @@ -271,8 +272,8 @@ public class AbstractIdentification exte * metadata contained in the given object are not recursively copied.</li> * </ul> * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static AbstractIdentification castOrCopy(final Identification object) { @@ -292,7 +293,7 @@ public class AbstractIdentification exte /** * Returns the citation for the resource(s). * - * @return Citation for the resource(s). + * @return citation for the resource(s). */ @Override @XmlElement(name = "citation", required = true) @@ -303,7 +304,7 @@ public class AbstractIdentification exte /** * Sets the citation for the resource(s). * - * @param newValue The new citation. + * @param newValue the new citation. */ public void setCitation(final Citation newValue) { checkWritePermission(); @@ -313,7 +314,7 @@ public class AbstractIdentification exte /** * Returns a brief narrative summary of the resource(s). * - * @return Brief narrative summary of the resource(s). + * @return brief narrative summary of the resource(s). */ @Override @XmlElement(name = "abstract", required = true) @@ -324,7 +325,7 @@ public class AbstractIdentification exte /** * Sets a brief narrative summary of the resource(s). * - * @param newValue The new summary of resource(s). + * @param newValue the new summary of resource(s). */ public void setAbstract(final InternationalString newValue) { checkWritePermission(); @@ -334,7 +335,7 @@ public class AbstractIdentification exte /** * Returns a summary of the intentions with which the resource(s) was developed. * - * @return The intentions with which the resource(s) was developed, or {@code null}. + * @return the intentions with which the resource(s) was developed, or {@code null}. */ @Override @XmlElement(name = "purpose") @@ -345,7 +346,7 @@ public class AbstractIdentification exte /** * Sets a summary of the intentions with which the resource(s) was developed. * - * @param newValue The new summary of intention. + * @param newValue the new summary of intention. */ public void setPurpose(final InternationalString newValue) { checkWritePermission(); @@ -359,7 +360,7 @@ public class AbstractIdentification exte * The element type may be changed to the {@code InternationalString} interface in GeoAPI 4.0. * </div> * - * @return Recognition of those who contributed to the resource(s). + * @return recognition of those who contributed to the resource(s). */ @Override @XmlElement(name = "credit") @@ -374,7 +375,7 @@ public class AbstractIdentification exte * The element type may be changed to the {@code InternationalString} interface in GeoAPI 4.0. * </div> * - * @param newValues The new credits. + * @param newValues the new credits. */ public void setCredits(final Collection<? extends String> newValues) { credits = writeCollection(newValues, credits, String.class); @@ -383,7 +384,7 @@ public class AbstractIdentification exte /** * Returns the status of the resource(s). * - * @return Status of the resource(s), or {@code null}. + * @return status of the resource(s), or {@code null}. */ @Override @XmlElement(name = "status") @@ -394,7 +395,7 @@ public class AbstractIdentification exte /** * Sets the status of the resource(s). * - * @param newValues The new status. + * @param newValues the new status. */ public void setStatus(final Collection<? extends Progress> newValues) { status = writeCollection(newValues, status, Progress.class); @@ -409,7 +410,7 @@ public class AbstractIdentification exte * This change may be applied in GeoAPI 4.0. * </div> * - * @return Means of communication with person(s) and organizations(s) associated with the resource(s). + * @return means of communication with person(s) and organizations(s) associated with the resource(s). * * @see org.apache.sis.metadata.iso.DefaultMetadata#getContacts() */ @@ -427,7 +428,7 @@ public class AbstractIdentification exte * This change may be applied in GeoAPI 4.0. * </div> * - * @param newValues The new points of contacts. + * @param newValues the new points of contacts. */ public void setPointOfContacts(final Collection<? extends ResponsibleParty> newValues) { pointOfContacts = writeCollection(newValues, pointOfContacts, ResponsibleParty.class); @@ -436,7 +437,7 @@ public class AbstractIdentification exte /** * Returns the methods used to spatially represent geographic information. * - * @return Methods used to spatially represent geographic information. + * @return methods used to spatially represent geographic information. * * @since 0.5 */ @@ -449,7 +450,7 @@ public class AbstractIdentification exte /** * Sets the method used to spatially represent geographic information. * - * @param newValues The new spatial representation types. + * @param newValues the new spatial representation types. * * @since 0.5 */ @@ -461,7 +462,7 @@ public class AbstractIdentification exte * Returns the factor which provides a general understanding of the density of spatial data in the resource(s). * This element should be repeated when describing upper and lower range. * - * @return Factor which provides a general understanding of the density of spatial data. + * @return factor which provides a general understanding of the density of spatial data. * * @since 0.5 */ @@ -474,7 +475,7 @@ public class AbstractIdentification exte /** * Sets the factor which provides a general understanding of the density of spatial data in the resource(s). * - * @param newValues The new spatial resolutions. + * @param newValues the new spatial resolutions. * * @since 0.5 */ @@ -485,7 +486,7 @@ public class AbstractIdentification exte /** * Returns the main theme(s) of the resource. * - * @return Main theme(s). + * @return main theme(s). * * @since 0.5 */ @@ -498,7 +499,7 @@ public class AbstractIdentification exte /** * Sets the main theme(s) of the resource. * - * @param newValues The new topic categories. + * @param newValues the new topic categories. * * @since 0.5 */ @@ -509,7 +510,7 @@ public class AbstractIdentification exte /** * Returns the spatial and temporal extent of the resource. * - * @return Spatial and temporal extent of the resource. + * @return spatial and temporal extent of the resource. * * @since 0.5 */ @@ -522,7 +523,7 @@ public class AbstractIdentification exte /** * Sets the spatial and temporal extent of the resource. * - * @param newValues The new extents + * @param newValues the new extents * * @since 0.5 */ @@ -533,7 +534,7 @@ public class AbstractIdentification exte /** * Returns other documentation associated with the resource. * - * @return Other documentation associated with the resource. + * @return other documentation associated with the resource. * * @since 0.5 */ @@ -546,7 +547,7 @@ public class AbstractIdentification exte /** * Sets other documentation associated with the resource. * - * @param newValues The documentation to associate with the resource. + * @param newValues the documentation to associate with the resource. * * @since 0.5 */ @@ -557,7 +558,7 @@ public class AbstractIdentification exte /** * Returns code(s) that identifies the level of processing in the producers coding system of a resource. * - * @return Code(s) that identifies the level of processing in the producers coding system of a resource. + * @return code(s) that identifies the level of processing in the producers coding system of a resource. * * @since 0.5 */ @@ -582,7 +583,7 @@ public class AbstractIdentification exte /** * Provides information about the frequency of resource updates, and the scope of those updates. * - * @return Frequency and scope of resource updates. + * @return frequency and scope of resource updates. */ @Override @XmlElement(name = "resourceMaintenance") @@ -593,7 +594,7 @@ public class AbstractIdentification exte /** * Sets information about the frequency of resource updates, and the scope of those updates. * - * @param newValues The new resource maintenance info. + * @param newValues the new resource maintenance info. */ public void setResourceMaintenances(final Collection<? extends MaintenanceInformation> newValues) { resourceMaintenances = writeCollection(newValues, resourceMaintenances, MaintenanceInformation.class); @@ -602,7 +603,7 @@ public class AbstractIdentification exte /** * Provides a graphic that illustrates the resource(s) (should include a legend for the graphic). * - * @return A graphic that illustrates the resource(s). + * @return a graphic that illustrates the resource(s). */ @Override @XmlElement(name = "graphicOverview") @@ -613,7 +614,7 @@ public class AbstractIdentification exte /** * Sets a graphic that illustrates the resource(s). * - * @param newValues The new graphics overviews. + * @param newValues the new graphics overviews. */ public void setGraphicOverviews(final Collection<? extends BrowseGraphic> newValues) { graphicOverviews = writeCollection(newValues, graphicOverviews, BrowseGraphic.class); @@ -622,7 +623,7 @@ public class AbstractIdentification exte /** * Provides a description of the format of the resource(s). * - * @return Description of the format. + * @return description of the format. */ @Override @XmlElement(name = "resourceFormat") @@ -633,7 +634,7 @@ public class AbstractIdentification exte /** * Sets a description of the format of the resource(s). * - * @param newValues The new resource format. + * @param newValues the new resource format. */ public void setResourceFormats(final Collection<? extends Format> newValues) { resourceFormats = writeCollection(newValues, resourceFormats, Format.class); @@ -642,7 +643,7 @@ public class AbstractIdentification exte /** * Provides category keywords, their type, and reference source. * - * @return Category keywords, their type, and reference source. + * @return category keywords, their type, and reference source. */ @Override @XmlElement(name = "descriptiveKeywords") @@ -653,7 +654,7 @@ public class AbstractIdentification exte /** * Sets category keywords, their type, and reference source. * - * @param newValues The new descriptive keywords. + * @param newValues the new descriptive keywords. */ public void setDescriptiveKeywords(final Collection<? extends Keywords> newValues) { descriptiveKeywords = writeCollection(newValues, descriptiveKeywords, Keywords.class); @@ -663,7 +664,7 @@ public class AbstractIdentification exte * Provides basic information about specific application(s) for which the resource(s) * has/have been or is being used by different users. * - * @return Information about specific application(s) for which the resource(s) + * @return information about specific application(s) for which the resource(s) * has/have been or is being used. */ @Override @@ -675,7 +676,7 @@ public class AbstractIdentification exte /** * Sets basic information about specific application(s). * - * @param newValues The new resource specific usages. + * @param newValues the new resource specific usages. */ public void setResourceSpecificUsages(final Collection<? extends Usage> newValues) { resourceSpecificUsages = writeCollection(newValues, resourceSpecificUsages, Usage.class); @@ -684,7 +685,7 @@ public class AbstractIdentification exte /** * Provides information about constraints which apply to the resource(s). * - * @return Constraints which apply to the resource(s). + * @return constraints which apply to the resource(s). */ @Override @XmlElement(name = "resourceConstraints") @@ -695,7 +696,7 @@ public class AbstractIdentification exte /** * Sets information about constraints which apply to the resource(s). * - * @param newValues The new resource constraints. + * @param newValues the new resource constraints. */ public void setResourceConstraints(final Collection<? extends Constraints> newValues) { resourceConstraints = writeCollection(newValues, resourceConstraints, Constraints.class); @@ -709,7 +710,7 @@ public class AbstractIdentification exte * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Associated resource information. + * @return associated resource information. * * @since 0.5 */ @@ -727,7 +728,7 @@ public class AbstractIdentification exte * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new associated resources. + * @param newValues the new associated resources. * * @since 0.5 */ @@ -738,7 +739,7 @@ public class AbstractIdentification exte /** * Provides aggregate dataset information. * - * @return Aggregate dataset information. + * @return aggregate dataset information. * * @deprecated As of ISO 19115:2014, replaced by {@link #getAssociatedResources()}. */ @@ -768,7 +769,7 @@ public class AbstractIdentification exte /** * Sets aggregate dataset information. * - * @param newValues The new aggregation info. + * @param newValues the new aggregation info. * * @deprecated As of ISO 19115:2014, replaced by {@link #setAssociatedResources(Collection)}. */
Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAggregateInformation.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAggregateInformation.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAggregateInformation.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAggregateInformation.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -58,6 +58,7 @@ import org.apache.sis.metadata.iso.citat * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_AggregateInformation_Type", propOrder = { "aggregateDataSetName", "aggregateDataSetIdentifier", @@ -91,7 +92,7 @@ public class DefaultAggregateInformation * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(AssociatedResource) */ @@ -117,8 +118,8 @@ public class DefaultAggregateInformation * metadata contained in the given object are not recursively copied.</li> * </ul> * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static DefaultAggregateInformation castOrCopy(final AggregateInformation object) { @@ -131,7 +132,7 @@ public class DefaultAggregateInformation /** * Citation information about the aggregate dataset. * - * @return Citation information about the aggregate dataset, or {@code null}. + * @return citation information about the aggregate dataset, or {@code null}. * * @deprecated As of ISO 19115:2014, replaced by {@link #getName()}. */ @@ -145,7 +146,7 @@ public class DefaultAggregateInformation /** * Sets the citation information about the aggregate dataset. * - * @param newValue The new citation. + * @param newValue the new citation. * * @deprecated As of ISO 19115:2014, replaced by {@link #setName(Citation)}. */ @@ -157,7 +158,7 @@ public class DefaultAggregateInformation /** * Identification information about aggregate dataset. * - * @return Identification information about aggregate dataset, or {@code null}. + * @return identification information about aggregate dataset, or {@code null}. * * @deprecated As of ISO 19115:2014, replaced by the first identifier of {@link #getAggregateDataSetName()}. */ @@ -187,7 +188,7 @@ public class DefaultAggregateInformation /** * Sets the identification information about aggregate dataset. * - * @param newValue The new identifier. + * @param newValue the new identifier. * * @deprecated As of ISO 19115:2014, replaced by an identifier of {@link #getAggregateDataSetName()}. */ @@ -223,7 +224,7 @@ public class DefaultAggregateInformation /** * Returns the type of relation between the resources. * - * @return Type of relation between the resources. + * @return association type of the aggregate dataset. */ @Override @XmlElement(name = "associationType", required = true) @@ -234,7 +235,7 @@ public class DefaultAggregateInformation /** * Sets the type of relation between the resources. * - * @param newValue The new type of relation. + * @param newValue the new association type. */ @Override public void setAssociationType(final AssociationType newValue) { @@ -244,7 +245,7 @@ public class DefaultAggregateInformation /** * Returns the type of initiative under which the associated resource was produced, or {@code null} if none. * - * @return The type of initiative under which the associated resource was produced, or {@code null} if none. + * @return type of initiative under which the aggregate dataset was produced, or {@code null}. */ @Override @XmlElement(name = "initiativeType") @@ -255,7 +256,7 @@ public class DefaultAggregateInformation /** * Sets a new type of initiative under which the associated resource was produced. * - * @param newValue The new type of initiative. + * @param newValue the new initiative. */ @Override public void setInitiativeType(final InitiativeType newValue) { Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAssociatedResource.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAssociatedResource.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAssociatedResource.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultAssociatedResource.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -55,6 +55,7 @@ import static org.opengis.annotation.Spe * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_AssociatedResource_Type" /*, propOrder = { "name", "associationType", @@ -98,8 +99,8 @@ public class DefaultAssociatedResource e /** * Constructs an associated resource initialized to the specified values. * - * @param name Citation information about the associated resource. - * @param associationType Type of relation between the resources. + * @param name citation information about the associated resource. + * @param associationType type of relation between the resources. */ public DefaultAssociatedResource(final Citation name, final AssociationType associationType) { this.name = name; @@ -124,7 +125,7 @@ public class DefaultAssociatedResource e * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. */ DefaultAssociatedResource(final AggregateInformation object) { if (object != null) { @@ -140,8 +141,8 @@ public class DefaultAssociatedResource e /** * Returns a SIS metadata implementation with the values of the given arbitrary implementation. * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ static DefaultAssociatedResource castOrCopy(final AggregateInformation object) { @@ -165,7 +166,7 @@ public class DefaultAssociatedResource e /** * Sets citation information about the associated resource. * - * @param newValue The new citation information, or {@code null}. + * @param newValue the new citation information, or {@code null}. */ public void setName(final Citation newValue) { checkWritePermission(); @@ -175,7 +176,7 @@ public class DefaultAssociatedResource e /** * Returns the type of relation between the resources. * - * @return Type of relation between the resources. + * @return type of relation between the resources. */ /// @XmlElement(name = "associationType", required = true) @UML(identifier="associationType", obligation=MANDATORY, specification=ISO_19115) @@ -186,7 +187,7 @@ public class DefaultAssociatedResource e /** * Sets the type of relation between the resources. * - * @param newValue The new type of relation. + * @param newValue the new type of relation. */ public void setAssociationType(final AssociationType newValue) { checkWritePermission(); @@ -196,7 +197,7 @@ public class DefaultAssociatedResource e /** * Returns the type of initiative under which the associated resource was produced, or {@code null} if none. * - * @return The type of initiative under which the associated resource was produced, or {@code null} if none. + * @return the type of initiative under which the associated resource was produced, or {@code null} if none. */ /// @XmlElement(name = "initiativeType") @UML(identifier="initiativeType", obligation=OPTIONAL, specification=ISO_19115) @@ -207,7 +208,7 @@ public class DefaultAssociatedResource e /** * Sets a new type of initiative under which the associated resource was produced. * - * @param newValue The new type of initiative. + * @param newValue the new type of initiative. */ public void setInitiativeType(final InitiativeType newValue) { checkWritePermission(); @@ -217,7 +218,7 @@ public class DefaultAssociatedResource e /** * Return a reference to the metadata of the associated resource, or {@code null} if none. * - * @return Reference to the metadata of the associated resource, or {@code null} if none. + * @return reference to the metadata of the associated resource, or {@code null} if none. */ /// @XmlElement(name = "metadataReference") @UML(identifier="metadataReference", obligation=CONDITIONAL, specification=ISO_19115) @@ -228,7 +229,7 @@ public class DefaultAssociatedResource e /** * Sets the reference to the metadata of the associated resource. * - * @param newValue The new reference to the metadata. + * @param newValue the new reference to the metadata. */ public void setMetadataReference(final Citation newValue) { checkWritePermission(); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultBrowseGraphic.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultBrowseGraphic.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultBrowseGraphic.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultBrowseGraphic.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -54,6 +54,7 @@ import static org.opengis.annotation.Spe * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_BrowseGraphic_Type", propOrder = { "fileName", "fileDescription", @@ -101,7 +102,7 @@ public class DefaultBrowseGraphic extend /** * Creates a browse graphics initialized to the specified URI. * - * @param fileName The name of the file that contains a graphic. + * @param fileName the name of the file that contains a graphic. */ public DefaultBrowseGraphic(final URI fileName) { this.fileName = fileName; @@ -112,7 +113,7 @@ public class DefaultBrowseGraphic extend * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(BrowseGraphic) */ @@ -143,8 +144,8 @@ public class DefaultBrowseGraphic extend * metadata contained in the given object are not recursively copied.</li> * </ul> * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static DefaultBrowseGraphic castOrCopy(final BrowseGraphic object) { @@ -157,7 +158,7 @@ public class DefaultBrowseGraphic extend /** * Returns the name of the file that contains a graphic that provides an illustration of the dataset. * - * @return File that contains a graphic that provides an illustration of the dataset, or {@code null}. + * @return file that contains a graphic that provides an illustration of the dataset, or {@code null}. */ @Override @XmlElement(name = "fileName", required = true) @@ -168,7 +169,7 @@ public class DefaultBrowseGraphic extend /** * Sets the name of the file that contains a graphic that provides an illustration of the dataset. * - * @param newValue The new filename. + * @param newValue the new filename. */ public void setFileName(final URI newValue) { checkWritePermission(); @@ -178,7 +179,7 @@ public class DefaultBrowseGraphic extend /** * Returns the text description of the illustration. * - * @return Text description of the illustration, or {@code null}. + * @return text description of the illustration, or {@code null}. */ @Override @XmlElement(name = "fileDescription") @@ -189,7 +190,7 @@ public class DefaultBrowseGraphic extend /** * Sets the text description of the illustration. * - * @param newValue The new file description. + * @param newValue the new file description. */ public void setFileDescription(final InternationalString newValue) { checkWritePermission(); @@ -203,7 +204,7 @@ public class DefaultBrowseGraphic extend * CGM, EPS, GIF, JPEG, PBM, PS, TIFF, XWD. * </div> * - * @return Format in which the illustration is encoded, or {@code null}. + * @return format in which the illustration is encoded, or {@code null}. */ @Override @XmlElement(name = "fileType") @@ -217,7 +218,7 @@ public class DefaultBrowseGraphic extend * Raster formats are encouraged to use one of the names returned by * {@link javax.imageio.ImageIO#getReaderFormatNames()}. * - * @param newValue The new file type. + * @param newValue the new file type. */ public void setFileType(final String newValue) { checkWritePermission(); @@ -227,7 +228,7 @@ public class DefaultBrowseGraphic extend /** * Returns the restrictions on access and / or use of browse graphic. * - * @return Restrictions on access and / or use of browse graphic. + * @return restrictions on access and / or use of browse graphic. * * @since 0.5 */ @@ -240,7 +241,7 @@ public class DefaultBrowseGraphic extend /** * Sets the restrictions on access and / or use of browse graphic. * - * @param newValues The new restrictions on access and / or use of browse graphic. + * @param newValues the new restrictions on access and / or use of browse graphic. * * @since 0.5 */ @@ -251,7 +252,7 @@ public class DefaultBrowseGraphic extend /** * Return the links to browse graphic. * - * @return The links to browse graphic. + * @return the links to browse graphic. * * @since 0.5 */ @@ -264,7 +265,7 @@ public class DefaultBrowseGraphic extend /** * Sets the links to browse graphic. * - * @param newValues The new links to browse graphic. + * @param newValues the new links to browse graphic. * * @since 0.5 */ Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultCoupledResource.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultCoupledResource.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultCoupledResource.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultCoupledResource.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -63,6 +63,7 @@ import static org.opengis.annotation.Spe * @since 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "SV_CoupledResource_Type", namespace = Namespaces.SRV, propOrder = { "operationName", "identifier", @@ -108,10 +109,10 @@ public class DefaultCoupledResource exte /** * Constructs a new coupled resource initialized to the specified values. * - * @param name Scoped identifier of the resource in the context of the given service instance. - * @param reference Reference to the reference to the resource on which the services operates. - * @param resource The tightly coupled resource. - * @param operation The service operation. + * @param name scoped identifier of the resource in the context of the given service instance. + * @param reference reference to the reference to the resource on which the services operates. + * @param resource the tightly coupled resource. + * @param operation the service operation. */ public DefaultCoupledResource(final ScopedName name, final Citation reference, @@ -129,7 +130,7 @@ public class DefaultCoupledResource exte * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(CoupledResource) */ @@ -158,7 +159,7 @@ public class DefaultCoupledResource exte /** * Sets the identifier of the resource in the context of the given service instance. * - * @param newValue The new identifier of the resource. + * @param newValue the new identifier of the resource. */ public void setScopedName(final ScopedName newValue) { checkWritePermission(); @@ -168,7 +169,7 @@ public class DefaultCoupledResource exte /** * Returns references to the resource on which the services operates. * - * @return References to the resource on which the services operates. + * @return references to the resource on which the services operates. */ /// @XmlElement(name = "resourceReference", namespace = Namespaces.SRV) @UML(identifier="resourceReference", obligation=OPTIONAL, specification=ISO_19115) @@ -179,7 +180,7 @@ public class DefaultCoupledResource exte /** * Sets references to the resource on which the services operates. * - * @param newValues The new references to the resource on which the services operates. + * @param newValues the new references to the resource on which the services operates. */ public void setResourceReferences(final Collection<? extends Citation> newValues) { resourceReferences = writeCollection(newValues, resourceReferences, Citation.class); @@ -199,7 +200,7 @@ public class DefaultCoupledResource exte /** * Sets the tightly coupled resources. * - * @param newValues The new tightly coupled resources. + * @param newValues the new tightly coupled resources. */ public void setResources(final Collection<? extends DataIdentification> newValues) { resources = writeCollection(newValues, resources, DataIdentification.class); @@ -213,7 +214,7 @@ public class DefaultCoupledResource exte * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return The service operation, or {@code null} if none. + * @return the service operation, or {@code null} if none. */ /// @XmlElement(name = "operation", namespace = Namespaces.SRV) @UML(identifier="operation", obligation=OPTIONAL, specification=ISO_19115) @@ -229,7 +230,7 @@ public class DefaultCoupledResource exte * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValue The new service operation. + * @param newValue the new service operation. */ public void setOperation(final DefaultOperationMetadata newValue) { checkWritePermission(); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultDataIdentification.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultDataIdentification.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultDataIdentification.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultDataIdentification.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -51,6 +51,7 @@ import static org.apache.sis.internal.ja * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_DataIdentification_Type", propOrder = { "languages", "characterSets", @@ -96,10 +97,10 @@ public class DefaultDataIdentification e /** * Creates a data identification initialized to the specified values. * - * @param citation The citation data for the resource(s), or {@code null} if none. - * @param abstracts A brief narrative summary of the content of the resource(s), or {@code null} if none. - * @param language The language used within the dataset, or {@code null} if none. - * @param topicCategory The main theme of the dataset, or {@code null} if none. + * @param citation the citation data for the resource(s), or {@code null} if none. + * @param abstracts a brief narrative summary of the content of the resource(s), or {@code null} if none. + * @param language the language used within the dataset, or {@code null} if none. + * @param topicCategory the main theme of the dataset, or {@code null} if none. */ public DefaultDataIdentification(final Citation citation, final CharSequence abstracts, @@ -116,7 +117,7 @@ public class DefaultDataIdentification e * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(DataIdentification) */ @@ -144,8 +145,8 @@ public class DefaultDataIdentification e * metadata contained in the given object are not recursively copied.</li> * </ul> * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static DefaultDataIdentification castOrCopy(final DataIdentification object) { @@ -163,7 +164,7 @@ public class DefaultDataIdentification e * <p>The language string representations should use ISO 639-2 language code as * returned by {@link Locale#getISO3Language()}.</p> * - * @return Language(s) used. + * @return language(s) used. * * @see Locale#getISO3Language() */ @@ -176,7 +177,7 @@ public class DefaultDataIdentification e /** * Sets the language(s) used within the dataset. * - * @param newValues The new languages. + * @param newValues the new languages. */ public void setLanguages(final Collection<? extends Locale> newValues) { languages = writeCollection(newValues, languages, Locale.class); @@ -189,7 +190,7 @@ public class DefaultDataIdentification e * The element type may change to the {@link Charset} class in GeoAPI 4.0. * </div> * - * @return Character coding standard(s) used. + * @return character coding standard(s) used. */ @Override @XmlElement(name = "characterSet") @@ -204,7 +205,7 @@ public class DefaultDataIdentification e * The element type may change to the {@link Charset} class in GeoAPI 4.0. * </div> * - * @param newValues The new character sets. + * @param newValues the new character sets. */ public void setCharacterSets(final Collection<? extends CharacterSet> newValues) { characterSets = writeCollection(newValues, characterSets, CharacterSet.class); @@ -214,7 +215,7 @@ public class DefaultDataIdentification e * Returns a description of the resource in the producer's processing environment. This includes * items such as the software, the computer operating system, file name, and the dataset size. * - * @return Description of the resource in the producer's processing environment, or {@code null}. + * @return description of the resource in the producer's processing environment, or {@code null}. */ @Override @XmlElement(name = "environmentDescription") @@ -225,7 +226,7 @@ public class DefaultDataIdentification e /** * Sets the description of the resource in the producers processing environment. * - * @param newValue The new environment description. + * @param newValue the new environment description. */ public void setEnvironmentDescription(final InternationalString newValue) { checkWritePermission(); @@ -235,7 +236,7 @@ public class DefaultDataIdentification e /** * Any other descriptive information about the resource. * - * @return Other descriptive information, or {@code null}. + * @return other descriptive information, or {@code null}. */ @Override @XmlElement(name = "supplementalInformation") @@ -246,7 +247,7 @@ public class DefaultDataIdentification e /** * Sets any other descriptive information about the resource. * - * @param newValue The new supplemental information. + * @param newValue the new supplemental information. */ public void setSupplementalInformation(final InternationalString newValue) { checkWritePermission(); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywordClass.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywordClass.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywordClass.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywordClass.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -52,6 +52,7 @@ import org.apache.sis.util.iso.Types; * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_KeywordClass_Type", propOrder = { "className", "conceptIdentifier", @@ -89,8 +90,8 @@ public class DefaultKeywordClass extends /** * Creates keyword class initialized to the given key name and ontology. * - * @param className A character string to label the keyword category in natural language. - * @param ontology Reference that binds the keyword class to a formal conceptualization of a knowledge domain. + * @param className a character string to label the keyword category in natural language. + * @param ontology reference that binds the keyword class to a formal conceptualization of a knowledge domain. */ public DefaultKeywordClass(final CharSequence className, final Citation ontology) { this.className = Types.toInternationalString(className); @@ -102,7 +103,7 @@ public class DefaultKeywordClass extends * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(KeywordClass) */ @@ -118,7 +119,7 @@ public class DefaultKeywordClass extends /** * Returns a label for the keyword category in natural language. * - * @return The keyword category in natural language. + * @return the keyword category in natural language. */ @XmlElement(name = "className", required = true) public InternationalString getClassName() { @@ -128,7 +129,7 @@ public class DefaultKeywordClass extends /** * Sets a label for the keyword category in natural language. * - * @param newValue The new keyword category in natural language. + * @param newValue the new keyword category in natural language. */ public void setClassName(final InternationalString newValue) { checkWritePermission(); @@ -148,7 +149,7 @@ public class DefaultKeywordClass extends /** * Sets the URI of concept in the ontology specified by the {@linkplain #getOntology() ontology} citation. * - * @param newValue The new URI of concept in the ontology. + * @param newValue the new URI of concept in the ontology. */ public void setConceptIdentifier(final URI newValue) { checkWritePermission(); @@ -158,7 +159,7 @@ public class DefaultKeywordClass extends /** * Returns a reference that binds the keyword class to a formal conceptualization of a knowledge domain. * - * @return A reference that binds the keyword class to a formal conceptualization. + * @return a reference that binds the keyword class to a formal conceptualization. */ @XmlElement(name = "ontology", required = true) public Citation getOntology() { @@ -168,7 +169,7 @@ public class DefaultKeywordClass extends /** * Sets a reference that binds the keyword class to a formal conceptualization of a knowledge domain. * - * @param newValue The new reference that binds the keyword class to a formal conceptualization. + * @param newValue the new reference that binds the keyword class to a formal conceptualization. */ public void setOntology(final Citation newValue) { checkWritePermission(); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywords.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywords.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywords.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultKeywords.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -52,6 +52,7 @@ import static org.opengis.annotation.Spe * @version 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_Keywords_Type", propOrder = { "keywords", "type", Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationChainMetadata.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationChainMetadata.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationChainMetadata.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationChainMetadata.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -58,6 +58,7 @@ import static org.opengis.annotation.Spe * @since 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "SV_OperationChainMetadata_Type", namespace = Namespaces.SRV, propOrder = { "name", "description", @@ -95,7 +96,7 @@ public class DefaultOperationChainMetada /** * Constructs a new operation chain metadata initialized to the specified name. * - * @param name The name as used by the service for this chain. + * @param name the name as used by the service for this chain. */ public DefaultOperationChainMetadata(final CharSequence name) { this.name = Types.toInternationalString(name); @@ -106,7 +107,7 @@ public class DefaultOperationChainMetada * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(OperationChainMetadata) */ @@ -122,7 +123,7 @@ public class DefaultOperationChainMetada /** * Returns the name as used by the service for this chain. * - * @return Name as used by the service for this chain. + * @return name as used by the service for this chain. */ @XmlElement(name = "name", namespace = Namespaces.SRV, required = true) @UML(identifier="name", obligation=MANDATORY, specification=ISO_19115) @@ -133,7 +134,7 @@ public class DefaultOperationChainMetada /** * Sets the name used by the service for this chain. * - * @param newValue The new name used by the service for this chain. + * @param newValue the new name used by the service for this chain. */ public void setName(final InternationalString newValue) { checkWritePermission(); @@ -143,7 +144,7 @@ public class DefaultOperationChainMetada /** * Returns a narrative explanation of the services in the chain and resulting output. * - * @return Narrative explanation of the services in the chain and resulting output, or {@code null} if none. + * @return narrative explanation of the services in the chain and resulting output, or {@code null} if none. */ @XmlElement(name = "description", namespace = Namespaces.SRV) @UML(identifier="description", obligation=OPTIONAL, specification=ISO_19115) @@ -154,7 +155,7 @@ public class DefaultOperationChainMetada /** * Sets the narrative explanation of the services in the chain and resulting output. * - * @param newValue The new a narrative explanation of the services in the chain and resulting output + * @param newValue the new a narrative explanation of the services in the chain and resulting output */ public void setDescription(final InternationalString newValue) { checkWritePermission(); @@ -169,7 +170,7 @@ public class DefaultOperationChainMetada * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Information about the operations applied by the chain. + * @return information about the operations applied by the chain. */ @XmlElement(name = "operation", namespace = Namespaces.SRV, required = true) @UML(identifier="operation", obligation=MANDATORY, specification=ISO_19115) @@ -185,7 +186,7 @@ public class DefaultOperationChainMetada * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new information about the operations applied by the chain. + * @param newValues the new information about the operations applied by the chain. */ public void setOperations(final List<? extends DefaultOperationMetadata> newValues) { operations = writeList(newValues, operations, DefaultOperationMetadata.class); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationMetadata.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationMetadata.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationMetadata.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultOperationMetadata.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -63,6 +63,7 @@ import static org.opengis.annotation.Spe * @since 0.5 * @module */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "SV_OperationMetadata_Type", namespace = Namespaces.SRV, propOrder = { "operationName", "distributedComputingPlatforms", @@ -126,7 +127,7 @@ public class DefaultOperationMetadata ex * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(OperationMetadata) */ @@ -147,7 +148,7 @@ public class DefaultOperationMetadata ex /** * Returns an unique identifier for this interface. * - * @return An unique identifier for this interface. + * @return an unique identifier for this interface. */ @XmlElement(name = "operationName", namespace = Namespaces.SRV, required = true) @UML(identifier="operationName", obligation=MANDATORY, specification=ISO_19115) @@ -158,7 +159,7 @@ public class DefaultOperationMetadata ex /** * Sets the unique identifier for this interface. * - * @param newValue The new unique identifier for this interface. + * @param newValue the new unique identifier for this interface. */ public void setOperationName(final String newValue) { checkWritePermission(); @@ -173,7 +174,7 @@ public class DefaultOperationMetadata ex * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Distributed computing platforms on which the operation has been implemented. + * @return distributed computing platforms on which the operation has been implemented. */ @XmlJavaTypeAdapter(DCPList.class) @XmlElement(name = "DCP", namespace = Namespaces.SRV, required = true) @@ -214,7 +215,7 @@ public class DefaultOperationMetadata ex * } * </div> * - * @param newValues The new distributed computing platforms on which the operation has been implemented. + * @param newValues the new distributed computing platforms on which the operation has been implemented. */ public void setDistributedComputingPlatforms(final Collection<? extends CodeList<?>> newValues) { distributedComputingPlatforms = writeCollection(newValues, distributedComputingPlatforms, (Class) CodeList.class); @@ -223,7 +224,7 @@ public class DefaultOperationMetadata ex /** * Returns free text description of the intent of the operation and the results of the operation. * - * @return Free text description of the intent of the operation and the results of the operation, or {@code null} if none. + * @return free text description of the intent of the operation and the results of the operation, or {@code null} if none. */ @XmlElement(name = "operationDescription", namespace = Namespaces.SRV) @UML(identifier="operationDescription", obligation=OPTIONAL, specification=ISO_19115) @@ -234,7 +235,7 @@ public class DefaultOperationMetadata ex /** * Sets free text description of the intent of the operation and the results of the operation. * - * @param newValue The new free text description of the intent of the operation and the results of the operation. + * @param newValue the new free text description of the intent of the operation and the results of the operation. */ public void setOperationDescription(final InternationalString newValue) { checkWritePermission(); @@ -244,7 +245,7 @@ public class DefaultOperationMetadata ex /** * Returns the name used to invoke this interface within the context of the DCP. * - * @return The name used to invoke this interface within the context of the distributed computing platforms, + * @return the name used to invoke this interface within the context of the distributed computing platforms, * or {@code null} if none. */ @XmlElement(name = "invocationName", namespace = Namespaces.SRV) @@ -256,7 +257,7 @@ public class DefaultOperationMetadata ex /** * Sets the name used to invoke this interface within the context of the DCP. * - * @param newValue The new name used to invoke this interface within the context of the DCP. + * @param newValue the new name used to invoke this interface within the context of the DCP. */ public void setInvocationName(final InternationalString newValue) { checkWritePermission(); @@ -266,7 +267,7 @@ public class DefaultOperationMetadata ex /** * Returns the handle for accessing the service interface. * - * @return Handle for accessing the service interface. + * @return handle for accessing the service interface. */ @XmlElement(name = "connectPoint", namespace = Namespaces.SRV, required = true) @UML(identifier="connectPoint", obligation=MANDATORY, specification=ISO_19115) @@ -277,7 +278,7 @@ public class DefaultOperationMetadata ex /** * Sets the handle for accessing the service interface. * - * @param newValue The new handle for accessing the service interface. + * @param newValue the new handle for accessing the service interface. */ public void setConnectPoints(final Collection<? extends OnlineResource> newValue) { connectPoints = writeCollection(newValue, connectPoints, OnlineResource.class); @@ -286,7 +287,7 @@ public class DefaultOperationMetadata ex /** * Returns the parameters that are required for this interface. * - * @return The parameters that are required for this interface, or an empty collection if none. + * @return the parameters that are required for this interface, or an empty collection if none. */ @SuppressWarnings("unchecked") @XmlElement(name = "parameters", namespace = Namespaces.SRV) @@ -298,7 +299,7 @@ public class DefaultOperationMetadata ex /** * Sets the parameters that are required for this interface. * - * @param newValues The new set of parameters that are required for this interface. + * @param newValues the new set of parameters that are required for this interface. */ @SuppressWarnings("unchecked") public void setParameters(final Collection<? extends ParameterDescriptor<?>> newValues) { @@ -313,7 +314,7 @@ public class DefaultOperationMetadata ex * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return List of operation that must be completed immediately, or an empty list if none. + * @return list of operation that must be completed immediately, or an empty list if none. */ @XmlElement(name = "dependsOn", namespace = Namespaces.SRV) @UML(identifier="dependsOn", obligation=OPTIONAL, specification=ISO_19115) @@ -329,7 +330,7 @@ public class DefaultOperationMetadata ex * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new list of operation. + * @param newValues the new list of operation. */ public void setDependsOn(final List<? extends DefaultOperationMetadata> newValues) { dependsOn = writeList(newValues, dependsOn, DefaultOperationMetadata.class); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultRepresentativeFraction.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultRepresentativeFraction.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultRepresentativeFraction.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultRepresentativeFraction.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -106,8 +106,8 @@ public class DefaultRepresentativeFracti /** * Creates a new representative fraction from the specified denominator. * - * @param denominator The denominator as a positive number, or 0 if unspecified. - * @throws IllegalArgumentException If the given value is negative. + * @param denominator the denominator as a positive number, or 0 if unspecified. + * @throws IllegalArgumentException if the given value is negative. */ public DefaultRepresentativeFraction(final long denominator) { ArgumentChecks.ensurePositive("denominator", denominator); @@ -124,7 +124,7 @@ public class DefaultRepresentativeFracti * metadata instances can also be obtained by unmarshalling an invalid XML document. * </div> * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. */ public DefaultRepresentativeFraction(final RepresentativeFraction object) { if (object != null) { @@ -140,8 +140,8 @@ public class DefaultRepresentativeFracti * property values of the given object, using a <cite>shallow</cite> copy operation * (i.e. properties are not cloned). * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static DefaultRepresentativeFraction castOrCopy(final RepresentativeFraction object) { @@ -152,7 +152,7 @@ public class DefaultRepresentativeFracti /** * Returns the denominator of this representative fraction. * - * @return The denominator. + * @return the denominator. */ @Override @ValueRange(minimum = 0) @@ -165,7 +165,7 @@ public class DefaultRepresentativeFracti /** * Sets the denominator value. * - * @param denominator The new denominator value, or 0 if none. + * @param denominator the new denominator value, or 0 if none. * @throws IllegalArgumentException if the given value is negative. */ public void setDenominator(final long denominator) { @@ -183,7 +183,7 @@ public class DefaultRepresentativeFracti * * <p>The equivalent of a {@code getScale()} method is {@link #doubleValue()}.</p> * - * @param scale The scale as a number between 0 exclusive and 1 inclusive, or NaN. + * @param scale the scale as a number between 0 exclusive and 1 inclusive, or NaN. * @throws IllegalArgumentException if the given scale is our of range. */ public void setScale(final double scale) { @@ -207,7 +207,7 @@ public class DefaultRepresentativeFracti * Returns the scale value of this representative fraction. * This method is the converse of {@link #setScale(double)}. * - * @return The scale value of this representative fraction, or NaN if none. + * @return the scale value of this representative fraction, or NaN if none. */ @Override public double doubleValue() { @@ -217,7 +217,7 @@ public class DefaultRepresentativeFracti /** * Returns the scale as a {@code float} type. * - * @return The scale. + * @return the scale. */ @Override public float floatValue() { @@ -287,7 +287,7 @@ public class DefaultRepresentativeFracti /** * Returns a modifiable copy of this representative fraction. * - * @return A modifiable copy of this representative fraction. + * @return a modifiable copy of this representative fraction. */ @Override public DefaultRepresentativeFraction clone() { @@ -295,7 +295,7 @@ public class DefaultRepresentativeFracti try { c = (DefaultRepresentativeFraction) super.clone(); } catch (CloneNotSupportedException e) { - throw new AssertionError(e); // Should never happen since we are cloneable. + throw new AssertionError(e); // Should never happen since we are cloneable. } c.isUnmodifiable = false; return c; @@ -304,7 +304,7 @@ public class DefaultRepresentativeFracti /** * Compares this object with the specified value for equality. * - * @param object The object to compare with. + * @param object the object to compare with. * @return {@code true} if both objects are equal. */ @Override @@ -334,7 +334,7 @@ public class DefaultRepresentativeFracti * Returns a string representation of this scale, or {@code NaN} if undefined. * If defined, the string representation uses the colon as in "1:20000". * - * @return A string representation of this scale. + * @return a string representation of this scale. */ @Override public String toString() { Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultResolution.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultResolution.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultResolution.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultResolution.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -65,6 +65,7 @@ import static org.opengis.annotation.Spe * * @see AbstractIdentification#getSpatialResolutions() */ +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. @XmlType(name = "MD_Resolution_Type") // No need for propOrder since this structure is a union (see javadoc). @XmlRootElement(name = "MD_Resolution") public class DefaultResolution extends ISOMetadata implements Resolution { @@ -214,7 +215,7 @@ public class DefaultResolution extends I checkWritePermission(); if (value != null && property != code) { if (newValue == null) { - return; // Do not erase the other property. + return; // Do not erase the other property. } Context.warningOccured(Context.current(), DefaultResolution.class, SETTERS[code-1], Messages.class, Messages.Keys.DiscardedExclusiveProperty_2, NAMES[property-1], NAMES[code-1]); Modified: sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultServiceIdentification.java URL: http://svn.apache.org/viewvc/sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultServiceIdentification.java?rev=1779559&r1=1779558&r2=1779559&view=diff ============================================================================== --- sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultServiceIdentification.java [UTF-8] (original) +++ sis/trunk/core/sis-metadata/src/main/java/org/apache/sis/metadata/iso/identification/DefaultServiceIdentification.java [UTF-8] Fri Jan 20 04:34:26 2017 @@ -59,7 +59,8 @@ import static org.opengis.annotation.Spe * @version 0.5 * @module */ -@XmlType(name = "MD_ServiceIdentification_Type", propOrder = { // ISO 19139 still use the old prefix. +@SuppressWarnings("CloneableClassWithoutClone") // ModifiableMetadata needs shallow clones. +@XmlType(name = "MD_ServiceIdentification_Type", propOrder = { // ISO 19139 still use the old prefix. "serviceType", "serviceTypeVersions", /// "accessProperties", @@ -143,9 +144,9 @@ public class DefaultServiceIdentificatio /** * Constructs a service identification initialized to the specified values. * - * @param serviceType Service type name. - * @param citation Citation data for the resource(s). - * @param abstracts Brief narrative summary of the content of the resource(s). + * @param serviceType service type name. + * @param citation citation data for the resource(s). + * @param abstracts brief narrative summary of the content of the resource(s). */ public DefaultServiceIdentification(final GenericName serviceType, final Citation citation, @@ -160,7 +161,7 @@ public class DefaultServiceIdentificatio * This is a <cite>shallow</cite> copy constructor, since the other metadata contained in the * given object are not recursively copied. * - * @param object The metadata to copy values from, or {@code null} if none. + * @param object the metadata to copy values from, or {@code null} if none. * * @see #castOrCopy(ServiceIdentification) */ @@ -196,8 +197,8 @@ public class DefaultServiceIdentificatio * metadata contained in the given object are not recursively copied.</li> * </ul> * - * @param object The object to get as a SIS implementation, or {@code null} if none. - * @return A SIS implementation containing the values of the given object (may be the + * @param object the object to get as a SIS implementation, or {@code null} if none. + * @return a SIS implementation containing the values of the given object (may be the * given object itself), or {@code null} if the argument was null. */ public static DefaultServiceIdentification castOrCopy(final ServiceIdentification object) { @@ -212,7 +213,7 @@ public class DefaultServiceIdentificatio * * <div class="note"><b>Examples:</b> "discovery", "view", "download", "transformation", or "invoke"</div> * - * @return A service type name. + * @return a service type name. */ @XmlElement(name = "serviceType", namespace = Namespaces.SRV, required = true) @UML(identifier="serviceType", obligation=MANDATORY, specification=ISO_19115) @@ -223,7 +224,7 @@ public class DefaultServiceIdentificatio /** * Sets the service type name. * - * @param newValue The new service type name. + * @param newValue the new service type name. */ public void setServiceType(final GenericName newValue) { checkWritePermission(); @@ -233,7 +234,7 @@ public class DefaultServiceIdentificatio /** * Returns the versions of the service. * - * @return The versions of the service. + * @return the versions of the service. */ @XmlElement(name = "serviceTypeVersion", namespace = Namespaces.SRV) @UML(identifier="serviceTypeVersion", obligation=OPTIONAL, specification=ISO_19115) @@ -244,7 +245,7 @@ public class DefaultServiceIdentificatio /** * Sets the versions of the service. * - * @param newValues The new versions of the service. + * @param newValues the new versions of the service. */ public void setServiceTypeVersions(final Collection<? extends String> newValues) { serviceTypeVersions = writeCollection(newValues, serviceTypeVersions, String.class); @@ -253,7 +254,7 @@ public class DefaultServiceIdentificatio /** * Returns information about the availability of the service. * - * @return Information about the availability of the service, or {@code null} if none. + * @return information about the availability of the service, or {@code null} if none. * * @since 0.5 */ @@ -267,7 +268,7 @@ public class DefaultServiceIdentificatio /** * Sets information about the availability of the service. * - * @param newValue The new information about the availability of the service. + * @param newValue the new information about the availability of the service. * * @since 0.5 */ @@ -284,7 +285,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Type of coupling between service and associated data, or {@code null} if none. + * @return type of coupling between service and associated data, or {@code null} if none. */ @XmlJavaTypeAdapter(SV_CouplingType.class) @XmlElement(name = "couplingType", namespace = Namespaces.SRV) @@ -325,7 +326,7 @@ public class DefaultServiceIdentificatio * } * </div> * - * @param newValue The new type of coupling between service and associated data. + * @param newValue the new type of coupling between service and associated data. */ public void setCouplingType(final CodeList<?> newValue) { checkWritePermission(); @@ -340,7 +341,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Further description(s) of the data coupling in the case of tightly coupled services. + * @return further description(s) of the data coupling in the case of tightly coupled services. */ @XmlElement(name = "coupledResource", namespace = Namespaces.SRV) @UML(identifier="coupledResource", obligation=CONDITIONAL, specification=ISO_19115) @@ -356,7 +357,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new further description(s) of the data coupling. + * @param newValues the new further description(s) of the data coupling. */ public void setCoupledResources(final Collection<? extends DefaultCoupledResource> newValues) { coupledResources = writeCollection(newValues, coupledResources, DefaultCoupledResource.class); @@ -365,7 +366,7 @@ public class DefaultServiceIdentificatio /** * Returns the reference(s) to the resource on which the service operates. * - * @return Reference(s) to the resource on which the service operates. + * @return reference(s) to the resource on which the service operates. * * @since 0.5 */ @@ -378,7 +379,7 @@ public class DefaultServiceIdentificatio /** * Sets the reference(s) to the resource on which the service operates. * - * @param newValues The new reference(s) to the resource on which the service operates. + * @param newValues the new reference(s) to the resource on which the service operates. * * @since 0.5 */ @@ -389,7 +390,7 @@ public class DefaultServiceIdentificatio /** * Returns the profile(s) to which the service adheres. * - * @return Profile(s) to which the service adheres. + * @return profile(s) to which the service adheres. * * @since 0.5 */ @@ -402,7 +403,7 @@ public class DefaultServiceIdentificatio /** * Sets the profile(s) to which the service adheres. * - * @param newValues The new profile(s) to which the service adheres. + * @param newValues the new profile(s) to which the service adheres. */ public void setProfiles(final Collection<? extends Citation> newValues) { profiles = writeCollection(newValues, profiles, Citation.class); @@ -411,7 +412,7 @@ public class DefaultServiceIdentificatio /** * Returns the standard(s) to which the service adheres. * - * @return Standard(s) to which the service adheres. + * @return standard(s) to which the service adheres. * * @since 0.5 */ @@ -424,7 +425,7 @@ public class DefaultServiceIdentificatio /** * Sets the standard(s) to which the service adheres. * - * @param newValues The new standard(s) to which the service adheres. + * @param newValues the new standard(s) to which the service adheres. * * @since 0.5 */ @@ -440,7 +441,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Information about the operations that comprise the service. + * @return information about the operations that comprise the service. */ @XmlElement(name = "containsOperations", namespace = Namespaces.SRV) @UML(identifier="containsOperations", obligation=OPTIONAL, specification=ISO_19115) @@ -456,7 +457,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new information(s) about the operations that comprise the service. + * @param newValues the new information(s) about the operations that comprise the service. */ public void setContainsOperations(final Collection<? extends DefaultOperationMetadata> newValues) { containsOperations = writeCollection(newValues, containsOperations, DefaultOperationMetadata.class); @@ -465,7 +466,7 @@ public class DefaultServiceIdentificatio /** * Provides information on the resources that the service operates on. * - * @return Information on the resources that the service operates on. + * @return information on the resources that the service operates on. */ @XmlElement(name = "operatesOn", namespace = Namespaces.SRV) @UML(identifier="operatesOn", obligation=OPTIONAL, specification=ISO_19115) @@ -476,7 +477,7 @@ public class DefaultServiceIdentificatio /** * Sets the information on the resources that the service operates on. * - * @param newValues The new information on the resources that the service operates on. + * @param newValues the new information on the resources that the service operates on. */ public void setOperatesOn(final Collection<? extends DataIdentification> newValues) { operatesOn = writeCollection(newValues, operatesOn, DataIdentification.class); @@ -490,7 +491,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @return Information about the chain applied by the service. + * @return information about the chain applied by the service. * * @since 0.5 */ @@ -508,7 +509,7 @@ public class DefaultServiceIdentificatio * when GeoAPI will provide it (tentatively in GeoAPI 3.1). * </div> * - * @param newValues The new information about the chain applied by the service. + * @param newValues the new information about the chain applied by the service. * * @since 0.5 */
