aboutsummaryrefslogtreecommitdiffstats
path: root/winery/org.eclipse.winery.repository/src/main/java/org/eclipse/winery/repository/backend/IRepository.java
blob: cb9560b43422415333bbd97580fb2ee0f7cf78b6 (plain)
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
/*******************************************************************************
 * Copyright (c) 2012-2013 University of Stuttgart.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * and the Apache License 2.0 which both accompany this distribution,
 * and are available at http://www.eclipse.org/legal/epl-v10.html
 * and http://www.apache.org/licenses/LICENSE-2.0
 *
 * Contributors:
 *     Oliver Kopp - initial API and implementation
 *******************************************************************************/
package org.eclipse.winery.repository.backend;

import java.util.Date;

import org.apache.commons.configuration.Configuration;
import org.eclipse.winery.common.RepositoryFileReference;
import org.eclipse.winery.common.ids.GenericId;

/**
 * Provides interface to the backend.
 * 
 * Currently a file-based backend is implemented. In the future, a git-based or
 * a database-based backend is possible.
 * 
 * The properties are managed by org.apache.commons.configuration. In case a new
 * backend is added, the appropriate implementation of
 * org.apache.commons.configuration.AbstrctConfiguration has to be chosen.
 * 
 */
public interface IRepository extends IGenericRepository {
	
	/**
	 * Returns the configuration of the specified id
	 * 
	 * If the associated TOSCA element does not exist, an empty configuration is
	 * returned. That means, the associated TOSCA element is created (SIDE
	 * EFFECT)
	 * 
	 * The returned configuration ensures that autoSave is activated
	 * 
	 * @param id may be a reference to a TOSCAcomponent or to a nested
	 *            TOSCAelement
	 * @return a Configuration, where isAutoSave == true
	 */
	Configuration getConfiguration(GenericId id);
	
	/**
	 * Enables resources to define additional properties. Currently used for
	 * tags.
	 * 
	 * Currently, more a quick hack. A generic TagsManager should be introduced
	 * to enable auto completion of tag names
	 * 
	 * If the associated TOSCA element does not exist, an empty configuration is
	 * returned. That means, the associated TOSCA element is created (SIDE
	 * EFFECT)
	 */
	Configuration getConfiguration(RepositoryFileReference ref);
	
	/**
	 * 
	 * @return the last change date of the configuration belonging to the given
	 *         id. NULL if the associated TOSCA element does not exist.
	 */
	Date getConfigurationLastUpdate(GenericId id);
	
}