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
|
/*
* Copyright (c) OSGi Alliance (2002, 2016). All Rights Reserved.
*
* 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.osgi.util.measurement;
/**
* Groups a state name, value and timestamp.
*
* <p>
* The state itself is represented as an integer and the time is measured in
* milliseconds since midnight, January 1, 1970 UTC.
*
* <p>
* A {@code State} object is immutable so that it may be easily shared.
*
* @Immutable
* @author $Id$
*/
public class State {
private final int value;
private final long time;
private final String name;
/**
* Create a new {@code State} object.
*
* @param value The value of the state.
* @param name The name of the state.
* @param time The time measured in milliseconds since midnight, January 1,
* 1970 UTC.
*/
public State(int value, String name, long time) {
this.value = value;
this.name = name;
this.time = time;
}
/**
* Create a new {@code State} object with a time of 0.
*
* @param value The value of the state.
* @param name The name of the state.
*/
public State(int value, String name) {
this(value, name, 0);
}
/**
* Returns the value of this {@code State}.
*
* @return The value of this {@code State} object.
*/
public final int getValue() {
return value;
}
/**
* Returns the time with which this {@code State} was created.
*
* @return The time with which this {@code State} was created. The time is
* measured in milliseconds since midnight, January 1, 1970 UTC.
*/
public final long getTime() {
return time;
}
/**
* Returns the name of this {@code State}.
*
* @return The name of this {@code State} object.
*/
public final String getName() {
return name;
}
/**
* Returns a {@code String} object representing this object.
*
* @return a {@code String} object representing this object.
*/
@Override
public String toString() {
StringBuilder sb = new StringBuilder();
sb.append(value);
if (name != null) {
sb.append(" \"");
sb.append(name);
sb.append("\"");
}
return sb.toString();
}
/**
* Returns a hash code value for this object.
*
* @return A hash code value for this object.
*/
@Override
public int hashCode() {
int hash = 31 * 17 + value;
if (name != null) {
hash = 31 * hash + name.hashCode();
}
return hash;
}
/**
* Return whether the specified object is equal to this object. Two
* {@code State} objects are equal if they have same value and name.
*
* @param obj The object to compare with this object.
* @return {@code true} if this object is equal to the specified object;
* {@code false} otherwise.
*/
@Override
public boolean equals(Object obj) {
if (this == obj) {
return true;
}
if (!(obj instanceof State)) {
return false;
}
State that = (State) obj;
if (value != that.value) {
return false;
}
if (name == that.name) {
return true;
}
if (name == null) {
return false;
}
return name.equals(that.name);
}
}
|
