blob: b78260c7b0e1290ee9da3512b3474e8943f9cfd3 (
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
|
package org.bukkit.block.data;
import org.bukkit.Material;
import org.bukkit.Server;
public interface BlockData extends Cloneable {
/**
* Get the Material represented by this block data.
*
* @return the material
*/
Material getMaterial();
/**
* Gets a string, which when passed into a method such as
* {@link Server#createBlockData(java.lang.String)} will unambiguously
* recreate this instance.
*
* @return serialized data string for this block
*/
String getAsString();
/**
* Merges all explicitly set states from the given data with this BlockData.
* <br>
* Note that the given data MUST have been created from one of the String
* parse methods, e.g. {@link Server#createBlockData(java.lang.String)} and
* not have been subsequently modified.
* <br>
* Note also that the block types must match identically.
*
* @param data the data to merge from
* @return a new instance of this blockdata with the merged data
*/
BlockData merge(BlockData data);
/**
* Checks if the specified BlockData matches this block data.
* <br>
* The semantics of this method are such that for manually created or
* modified BlockData it has the same effect as
* {@link Object#equals(java.lang.Object)}, whilst for parsed data (that to
* which {@link #merge(org.bukkit.block.data.BlockData)} applies, it will
* return true when the type and all explicitly set states match.
* <br>
* <b>Note that these semantics mean that a.matches(b) may not be the same
* as b.matches(a)</b>
*
* @param data the data to match against (normally a parsed constant)
* @return if there is a match
*/
boolean matches(BlockData data);
/**
* Returns a copy of this BlockData.
*
* @return a copy of the block data
*/
BlockData clone();
}
|