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
|
/**
* Copyright (c) 2011 Mia-Software.
*
* 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:
* Nicolas Guyomar (Mia-Software) - Bug 338813 - [EMF Facet Framework] basic Facet actions
* Nicolas Bros (Mia-Software) - Bug 361617 - Deprecation of APIs for the old Facet metamodels
*/
package org.eclipse.papyrus.emf.facet.efacet.core;
import java.io.IOException;
import org.eclipse.core.resources.IFile;
import org.eclipse.emf.ecore.EOperation;
import org.eclipse.emf.ecore.EParameter;
import org.eclipse.emf.edit.domain.EditingDomain;
import org.eclipse.papyrus.emf.facet.efacet.Facet;
import org.eclipse.papyrus.emf.facet.efacet.FacetAttribute;
import org.eclipse.papyrus.emf.facet.efacet.FacetOperation;
import org.eclipse.papyrus.emf.facet.efacet.FacetReference;
import org.eclipse.papyrus.emf.facet.efacet.FacetSet;
import org.eclipse.papyrus.emf.facet.efacet.core.internal.FacetActionImpl;
import org.eclipse.papyrus.emf.facet.efacet.core.internal.incubatingapi.IFacetActions2;
import org.eclipse.papyrus.emf.facet.util.emf.core.exception.InvalidFacetSetException;
/**
* This interface contains methods declaration to deal with {@link Facet} and {@link FacetSet}.
*
* @since 0.1
* @noimplement
* @noextend
* @deprecated use {@link IFacetActions2} with the new eFacet2 metamodel (https://bugs.eclipse.org/bugs/show_bug.cgi?id=381226)
*/
@Deprecated
public interface IFacetAction {
IFacetAction INSTANCE = new FacetActionImpl();
/**
* Add the given facetSet to the given facetSet model file, which will be created
*
* @param facetSet
* the facetSet to be created. Cannot be <code>null</code>
* @param project
* the new file in which the facetSet has to be created. Cannot be <code>null</code>,
* and cannot already exist
* @since 0.2
*/
void createFacetSet(FacetSet facetSet, IFile file) throws IOException,
InvalidFacetSetException;
/**
* Add the given {@link Facet} to the given {@link FacetSet}
*
* @param facetSet
* the parent facetSet, cannot be null
* @param facet
* the {@link Facet}, cannot be null, or contained by a resource
* @param editingDomain
* the editing domain needed to perform the Add EMF command, cannot be null
*/
Facet createFacetInFacetSet(FacetSet facetSet, Facet facet,
EditingDomain editingDomain);
/**
* Add the given {@link FacetAttribute} to the given {@link Facet}
*
* @param facet
* the parent {@link Facet}, cannot be null
* @param facetAttribute
* the {@link FacetAttribute}, cannot be null, or contained by a resource
* @param editingDomain
* the editing domain needed to perform the Add Emf command, cannot be null
*/
void addAttributeInFacet(Facet facet, FacetAttribute facetAttribute,
EditingDomain editingDomain);
/**
* Add the given {@link FacetReference} to the given {@link Facet}
*
* @param facet
* the parent {@link Facet}, cannot be null
* @param facetReference
* the {@link FacetReference}, cannot be null, or contained by a resource
* @param editingDomain
* the editing domain needed to perform the Add Emf command, cannot be null
*/
void addReferenceInFacet(Facet facet, FacetReference facetReference,
EditingDomain editingDomain);
/**
* Add a new {@link FacetOperation} to the given {@link Facet}
*
* @param facet
* the parent {@link Facet}, cannot be null
* @param facetOperation
* the new {@link FacetOperation}, cannot be null, or contained by a resource
* @param editingDomain
* the editing domain needed to perform the Add Emf command, cannot be null
*/
void addOperationInFacet(Facet facet, FacetOperation facetOperation,
EditingDomain editingDomain);
/**
* Add a new {@link EParameter} to the given {@link FacetOperation}
*
* @param operation
* the parent {@link EOperation}
* @param parameter
* the new {@link EParameter}
* @param editingDomain
* the editing domain needed to perform the Add Emf command, cannot be null
*/
void addParameterInOperation(FacetOperation operation,
EParameter parameter, EditingDomain editingDomain);
/**
* Set the given URI to the given {@link FacetSet}
*
* @param facetSet
* the {@link FacetSet} to be modified
* @param nsUri
* the Uri
* @param editingDomain
* the editing domain needed to perform the Set Emf command, cannot be null
*/
void setFacetSetNsUri(FacetSet facetSet, String nsUri,
EditingDomain editingDomain);
}
|
