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
|
/*******************************************************************************
* Copyright (c) 2007, 2009 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
*******************************************************************************/
package org.eclipse.equinox.p2.repository;
import java.net.URI;
import java.util.Map;
import org.eclipse.core.runtime.IAdaptable;
import org.eclipse.equinox.internal.provisional.p2.metadata.query.IQueryable;
/**
* Base interface that defines common properties that may be provided by
* various kinds of repositories.
*
* @noimplement This interface is not intended to be implemented by clients.
* @since 2.0
*/
public interface IRepository<T> extends IAdaptable, IQueryable<T> {
/**
* The key for a boolean property indicating that the repository
* is a system repository. System repositories are implementation details
* that are not subject to general access, hidden from the typical user, etc.
*/
public static final String PROP_SYSTEM = "p2.system"; //$NON-NLS-1$
/**
* The key for a boolean property indicating that repository metadata is
* stored in compressed form. A compressed repository will have lower
* bandwidth cost to read when remote, but higher processing cost to
* uncompress when reading.
*/
public static final String PROP_COMPRESSED = "p2.compressed"; //$NON-NLS-1$
/**
* The key for a string property providing a human-readable name for the repository.
*/
public static final String PROP_NAME = "name"; //$NON-NLS-1$
/**
* The key for a string property providing a user-defined name for the repository.
* This property is never stored in the repository itself, but is instead tracked and managed
* by an {@link IRepositoryManager}.
*/
public static final String PROP_NICKNAME = "p2.nickname"; //$NON-NLS-1$
/**
* The key for a string property providing a human-readable description for the repository.
*/
public static final String PROP_DESCRIPTION = "description"; //$NON-NLS-1$
/**
* The key for a string property providing the common base URL that should
* be replaced with the mirror URL.
*/
public static final String PROP_MIRRORS_BASE_URL = "p2.mirrorsBaseURL"; //$NON-NLS-1$
/**
* The key for a string property providing a URL that can return mirrors of this
* repository.
*/
public static final String PROP_MIRRORS_URL = "p2.mirrorsURL"; //$NON-NLS-1$
/**
* The key for a string property containing the time when the repository was last modified.
*/
public static final String PROP_TIMESTAMP = "p2.timestamp"; //$NON-NLS-1$
/**
* The key for a string property providing the user name to an authenticated
* URL. This key is used in the secure preference store for repository data.
* @see #PREFERENCE_NODE
*/
public static final String PROP_USERNAME = "username"; //$NON-NLS-1$
/**
* The key for a string property providing the password to an authenticated
* URL. This key is used in the secure preference store for repository data.
* @see #PREFERENCE_NODE
*/
public static final String PROP_PASSWORD = "password"; //$NON-NLS-1$
/**
* The node identifier for repository secure preference store.
*/
public static final String PREFERENCE_NODE = "org.eclipse.equinox.p2.repository"; //$NON-NLS-1$
/**
* A repository type constant (value 0) representing a metadata repository.
*/
public static final int TYPE_METADATA = 0;
/**
* A repository type constant (value 1) representing an artifact repository.
*/
public static final int TYPE_ARTIFACT = 1;
/**
* General purpose zero-valued bit mask constant. Useful whenever you need to
* supply a bit mask with no bits set.
*/
public static final int NONE = 0;
/**
* An option flag constant (value 1) indicating an enabled repository.
*/
public static final int ENABLED = 1;
/**
* Returns the URL of the repository.
* TODO: Should we use URL or URI? URL requires a protocol handler
* to be installed in Java. Can the URL have any protocol?
* @return the URL of the repository.
*/
public URI getLocation();
/**
* Returns the name of the repository.
* @return the name of the repository.
*/
public String getName();
/**
* Returns a string representing the type of the repository.
* @return the type of the repository.
*/
public String getType();
/**
* Returns a string representing the version for the repository type.
* @return the version of the type of the repository.
*/
public String getVersion();
/**
* Returns a brief description of the repository.
* @return the description of the repository.
*/
public String getDescription();
/**
* Returns the name of the provider of the repository.
* @return the provider of this repository.
*/
public String getProvider();
/**
* Returns a read-only collection of the properties of the repository.
* @return the properties of this repository.
*/
public Map<String, String> getProperties();
/**
* Returns <code>true</code> if this repository can be modified.
* @return whether or not this repository can be modified
*/
public boolean isModifiable();
/**
* Set the name of the repository.
*/
public void setName(String name);
/**
* Sets the description of the repository.
*/
public void setDescription(String description);
/**
* Sets the value of the property with the given key. Returns the old property
* associated with that key, if any. Setting a value of <code>null</code> will
* remove the corresponding key from the properties of this repository.
*
* @param key The property key
* @param value The new property value, or <code>null</code> to remove the key
* @return The old property value, or <code>null</code> if there was no old value
*/
public String setProperty(String key, String value);
/**
* Sets the name of the provider of the repository.
*/
public void setProvider(String provider);
}
|
