1 /**
2 * Licensed to the Apache Software Foundation (ASF) under one or more
3 * contributor license agreements. See the NOTICE file distributed with
4 * this work for additional information regarding copyright ownership.
5 * The ASF licenses this file to You under the Apache License, Version 2.0
6 * (the "License"); you may not use this file except in compliance with
7 * the License. You may obtain a copy of the License at
8 *
9 * http://www.apache.org/licenses/LICENSE-2.0
10 *
11 * Unless required by applicable law or agreed to in writing, software
12 * distributed under the License is distributed on an "AS IS" BASIS,
13 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14 * See the License for the specific language governing permissions and
15 * limitations under the License.
16 */
17 package org.apache.tika.metadata;
18
19 /**
20 * A collection of Dublin Core metadata names.
21 *
22 * @see <a href="http://dublincore.org">dublincore.org</a>
23 *
24 *
25 */
26 public interface DublinCore {
27
28 /**
29 * Typically, Format may include the media-type or dimensions of the resource.
30 * Format may be used to determine the software, hardware or other equipment
31 * needed to display or operate the resource. Examples of dimensions include
32 * size and duration. Recommended best practice is to select a value from a
33 * controlled vocabulary (for example, the list of Internet Media Types [MIME]
34 * defining computer media formats).
35 */
36 public static final String FORMAT = "format";
37
38 /**
39 * Recommended best practice is to identify the resource by means of a string
40 * or number conforming to a formal identification system. Example formal
41 * identification systems include the Uniform Resource Identifier (URI)
42 * (including the Uniform Resource Locator (URL)), the Digital Object
43 * Identifier (DOI) and the International Standard Book Number (ISBN).
44 */
45 public static final String IDENTIFIER = "identifier";
46
47 /**
48 * Date on which the resource was changed.
49 */
50 public static final String MODIFIED = "modified";
51
52 /**
53 * An entity responsible for making contributions to the content of the
54 * resource. Examples of a Contributor include a person, an organisation, or a
55 * service. Typically, the name of a Contributor should be used to indicate
56 * the entity.
57 */
58 public static final String CONTRIBUTOR = "contributor";
59
60 /**
61 * The extent or scope of the content of the resource. Coverage will typically
62 * include spatial location (a place name or geographic coordinates), temporal
63 * period (a period label, date, or date range) or jurisdiction (such as a
64 * named administrative entity). Recommended best practice is to select a
65 * value from a controlled vocabulary (for example, the Thesaurus of
66 * Geographic Names [TGN]) and that, where appropriate, named places or time
67 * periods be used in preference to numeric identifiers such as sets of
68 * coordinates or date ranges.
69 */
70 public static final String COVERAGE = "coverage";
71
72 /**
73 * An entity primarily responsible for making the content of the resource.
74 * Examples of a Creator include a person, an organisation, or a service.
75 * Typically, the name of a Creator should be used to indicate the entity.
76 */
77 public static final String CREATOR = "creator";
78
79 /**
80 * A date associated with an event in the life cycle of the resource.
81 * Typically, Date will be associated with the creation or availability of the
82 * resource. Recommended best practice for encoding the date value is defined
83 * in a profile of ISO 8601 [W3CDTF] and follows the YYYY-MM-DD format.
84 */
85 public static final String DATE = "date";
86
87 /**
88 * An account of the content of the resource. Description may include but is
89 * not limited to: an abstract, table of contents, reference to a graphical
90 * representation of content or a free-text account of the content.
91 */
92 public static final String DESCRIPTION = "description";
93
94 /**
95 * A language of the intellectual content of the resource. Recommended best
96 * practice is to use RFC 3066 [RFC3066], which, in conjunction with ISO 639
97 * [ISO639], defines two- and three-letter primary language tags with optional
98 * subtags. Examples include "en" or "eng" for English, "akk" for Akkadian,
99 * and "en-GB" for English used in the United Kingdom.
100 */
101 public static final String LANGUAGE = "language";
102
103 /**
104 * An entity responsible for making the resource available. Examples of a
105 * Publisher include a person, an organisation, or a service. Typically, the
106 * name of a Publisher should be used to indicate the entity.
107 */
108 public static final String PUBLISHER = "publisher";
109
110 /**
111 * A reference to a related resource. Recommended best practice is to
112 * reference the resource by means of a string or number conforming to a
113 * formal identification system.
114 */
115 public static final String RELATION = "relation";
116
117 /**
118 * Information about rights held in and over the resource. Typically, a Rights
119 * element will contain a rights management statement for the resource, or
120 * reference a service providing such information. Rights information often
121 * encompasses Intellectual Property Rights (IPR), Copyright, and various
122 * Property Rights. If the Rights element is absent, no assumptions can be
123 * made about the status of these and other rights with respect to the
124 * resource.
125 */
126 public static final String RIGHTS = "rights";
127
128 /**
129 * A reference to a resource from which the present resource is derived. The
130 * present resource may be derived from the Source resource in whole or in
131 * part. Recommended best practice is to reference the resource by means of a
132 * string or number conforming to a formal identification system.
133 */
134 public static final String SOURCE = "source";
135
136 /**
137 * The topic of the content of the resource. Typically, a Subject will be
138 * expressed as keywords, key phrases or classification codes that describe a
139 * topic of the resource. Recommended best practice is to select a value from
140 * a controlled vocabulary or formal classification scheme.
141 */
142 public static final String SUBJECT = "subject";
143
144 /**
145 * A name given to the resource. Typically, a Title will be a name by which
146 * the resource is formally known.
147 */
148 public static final String TITLE = "title";
149
150 /**
151 * The nature or genre of the content of the resource. Type includes terms
152 * describing general categories, functions, genres, or aggregation levels for
153 * content. Recommended best practice is to select a value from a controlled
154 * vocabulary (for example, the DCMI Type Vocabulary [DCMITYPE]). To describe
155 * the physical or digital manifestation of the resource, use the Format
156 * element.
157 */
158 public static final String TYPE = "type";
159
160 }