1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
|
/*******************************************************************************
* Copyright (c) 2000, 2010 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
* Red Hat Inc. - 406902 (nested categories)
*******************************************************************************/
package org.eclipse.equinox.internal.p2.updatesite;
import java.net.MalformedURLException;
import java.net.URL;
import java.util.*;
/**
* A category in an update site.
*
* Based on org.eclipse.update.core.model.CategoryModel.
*/
public class SiteCategory {
private static Comparator<SiteCategory> comp;
private String description;
private String label;
private String name;
private List<String> categoryNames;
private Map<Locale, Map<String, String>> localizations;
/**
* Returns a comparator for category models.
*
* @return comparator
* @since 2.0
*/
public static Comparator<SiteCategory> getComparator() {
if (comp == null) {
comp = new Comparator<SiteCategory>() {
/*
* @see Comparator#compare(Object,Object)
* Returns 0 if versions are equal.
* Returns -1 if object1 is after than object2.
* Returns +1 if object1 is before than object2.
*/
public int compare(SiteCategory cat1, SiteCategory cat2) {
if (cat1.equals(cat2))
return 0;
return cat1.getName().compareTo(cat2.getName());
}
};
}
return comp;
}
/**
* Creates an uninitialized model object.
*
* @since 2.0
*/
public SiteCategory() {
super();
}
/**
* Compare two category models for equality.
*
* @see Object#equals(Object)
* @since 2.0
*/
public boolean equals(Object obj) {
boolean result = false;
if (obj instanceof SiteCategory) {
SiteCategory otherCategory = (SiteCategory) obj;
result = getName().equalsIgnoreCase(otherCategory.getName());
}
return result;
}
/**
* Retrieve the detailed category description
*
* @return category description, or <code>null</code>.
* @since 2.0
*/
public String getDescription() {
return description;
}
/**
* Retrieve the non-localized displayable label for the category.
*
* @return non-localized displayable label, or <code>null</code>.
* @since 2.0
*/
public String getLabel() {
return label;
}
/**
* Gets the localizations for the site as a map from locale
* to the set of translated properties for that locale.
*
* @return a map from locale to property set
* @since 3.4
*/
public Map<Locale, Map<String, String>> getLocalizations() {
return this.localizations;
}
/**
* Retrieve the name of the category.
*
* @return category name, or <code>null</code>.
* @since 2.0
*/
public String getName() {
return name;
}
/**
* Compute hash code for category model.
*
* @see Object#hashCode()
* @since 2.0
*/
public int hashCode() {
return getName().hashCode();
}
/**
* Resolve the model object.
* Any URL strings in the model are resolved relative to the
* base URL argument. Any translatable strings in the model that are
* specified as translation keys are localized using the supplied
* resource bundle.
*
* @param base URL
* @param bundleURL resource bundle URL
* @exception MalformedURLException
* @since 2.0
*/
public void resolve(URL base, URL bundleURL) throws MalformedURLException {
// resolve local elements
// localizedLabel = resolveNLString(bundleURL, label);
// delegate to references
// resolveReference(getDescriptionModel(), base, bundleURL);
}
/**
* Sets the category description.
* Throws a runtime exception if this object is marked read-only.
*
* @param description category description
* @since 2.0
*/
public void setDescription(String description) {
this.description = description;
}
/**
* Sets the category displayable label.
* Throws a runtime exception if this object is marked read-only.
*
* @param label displayable label, or resource key
* @since 2.0
*/
public void setLabel(String label) {
this.label = label;
}
/**
* Sets the localizations for the site as a map from locale
* to the set of translated properties for that locale.
*
* @param localizations as a map from locale to property set
* @since 3.4
*/
public void setLocalizations(Map<Locale, Map<String, String>> localizations) {
this.localizations = localizations;
}
/**
* Sets the category name.
* Throws a runtime exception if this object is marked read-only.
*
* @param name category name
* @since 2.0
*/
public void setName(String name) {
this.name = name;
}
/**
* Adds the name of a category this bundle belongs to.
* Throws a runtime exception if this object is marked read-only.
*
* @param categoryName category name
*/
public void addCategoryName(String categoryName) {
if (this.categoryNames == null) {
this.categoryNames = new ArrayList<String>();
}
if (!this.categoryNames.contains(categoryName)) {
this.categoryNames.add(categoryName);
}
}
/**
* Returns the names of categories the referenced feature belongs to.
*
* @return an array of names, or an empty array.
*/
public String[] getCategoryNames() {
if (categoryNames == null)
return new String[0];
return categoryNames.toArray(new String[0]);
}
}
|
