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
|
/*
* Copyright 2015 Open Networking Laboratory
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package org.onosproject.net.group;
import static com.google.common.base.Preconditions.checkNotNull;
import java.util.Objects;
import org.onosproject.core.GroupId;
/**
* Group operation definition to be used between core and provider
* layers of group subsystem.
*
*/
public final class GroupOperation {
private final Type opType;
private final GroupId groupId;
private final GroupDescription.Type groupType;
private final GroupBuckets buckets;
public enum Type {
/**
* Create a group in a device with the specified parameters.
*/
ADD,
/**
* Modify a group in a device with the specified parameters.
*/
MODIFY,
/**
* Delete a specified group.
*/
DELETE
}
/**
* Group operation constructor with the parameters.
*
* @param opType group operation type
* @param groupId group Identifier
* @param groupType type of the group
* @param buckets immutable list of group buckets to be part of group
*/
private GroupOperation(Type opType,
GroupId groupId,
GroupDescription.Type groupType,
GroupBuckets buckets) {
this.opType = checkNotNull(opType);
this.groupId = checkNotNull(groupId);
this.groupType = checkNotNull(groupType);
this.buckets = buckets;
}
/**
* Creates ADD group operation object.
*
* @param groupId group Identifier
* @param groupType type of the group
* @param buckets immutable list of group buckets to be part of group
* @return add group operation object
*/
public static GroupOperation createAddGroupOperation(GroupId groupId,
GroupDescription.Type groupType,
GroupBuckets buckets) {
checkNotNull(buckets);
return new GroupOperation(Type.ADD, groupId, groupType, buckets);
}
/**
* Creates MODIFY group operation object.
*
* @param groupId group Identifier
* @param groupType type of the group
* @param buckets immutable list of group buckets to be part of group
* @return modify group operation object
*/
public static GroupOperation createModifyGroupOperation(GroupId groupId,
GroupDescription.Type groupType,
GroupBuckets buckets) {
checkNotNull(buckets);
return new GroupOperation(Type.MODIFY, groupId, groupType, buckets);
}
/**
* Creates DELETE group operation object.
*
* @param groupId group Identifier
* @param groupType type of the group
* @return delete group operation object
*/
public static GroupOperation createDeleteGroupOperation(GroupId groupId,
GroupDescription.Type groupType) {
return new GroupOperation(Type.DELETE, groupId, groupType, null);
}
/**
* Returns group operation type.
*
* @return GroupOpType group operation type
*/
public Type opType() {
return this.opType;
}
/**
* Returns group identifier attribute of the operation.
*
* @return GroupId group identifier
*/
public GroupId groupId() {
return this.groupId;
}
/**
* Returns group type attribute of the operation.
*
* @return GroupType group type
*/
public GroupDescription.Type groupType() {
return this.groupType;
}
/**
* Returns group buckets associated with the operation.
*
* @return GroupBuckets group buckets
*/
public GroupBuckets buckets() {
return this.buckets;
}
@Override
/*
* The deviceId, type and buckets are used for hash.
*
* (non-Javadoc)
* @see java.lang.Object#equals(java.lang.Object)
*/
public int hashCode() {
return (buckets != null) ? Objects.hash(groupId, opType, buckets) :
Objects.hash(groupId, opType);
}
@Override
/*
* The deviceId, type and buckets should be same.
*
* (non-Javadoc)
* @see java.lang.Object#equals(java.lang.Object)
*/
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (obj instanceof GroupOperation) {
GroupOperation that = (GroupOperation) obj;
return Objects.equals(groupId, that.groupId) &&
Objects.equals(groupType, that.groupType) &&
Objects.equals(opType, that.opType) &&
Objects.equals(buckets, that.buckets);
}
return false;
}
}
|
