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
|
/*
* Copyright (C) 2010 Google Inc.
*
* 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 com.android.i18n.addressinput;
import java.util.HashMap;
import java.util.Map;
/**
* Defines the character codes used in the metadata to specify the types of fields used in address
* formatting. Note that the metadata also has a character for newlines, which is not defined here.
*/
public enum AddressField {
ADMIN_AREA('S', "state"),
LOCALITY('C', "city"),
RECIPIENT('N', "name"),
ORGANIZATION('O', "organization"),
// Deprecated - use A instead.
ADDRESS_LINE_1('1', "street1"),
// Deprecated - use A instead.
ADDRESS_LINE_2('2', "street2"),
DEPENDENT_LOCALITY('D'),
POSTAL_CODE('Z'),
SORTING_CODE('X'),
STREET_ADDRESS('A'),
COUNTRY('R');
/**
* Enum for width types of address input fields.
*/
public enum WidthType {
LONG,
SHORT;
}
private static final Map<Character, AddressField> FIELD_MAPPING
= new HashMap<Character, AddressField>();
static {
for (AddressField value : values()) {
FIELD_MAPPING.put(value.getChar(), value);
}
}
private final char mField;
private final String mAttributeName;
private AddressField(char field, String attributeName) {
mField = field;
mAttributeName = attributeName;
}
private AddressField(char field) {
this(field, null);
}
/**
* Gets the corresponding AddressField for the character code. Returns null if the character is
* not recognized.
*/
static AddressField of(char field) {
return FIELD_MAPPING.get(field);
}
/**
* Gets attribute name. Attribute names are used as keys to JSON address data returned from the
* server. Returns null if the field does not have a corresponding attribute name.
*
* Note: Not all address fields have attribute names. Fields like postal code, country, sorting
* code, or street address do not have attribute names.
*/
String getAttributeName() {
return mAttributeName;
}
/**
* Gets the field's identification character, as used in the metadata.
*
* @return identification char.
*/
char getChar() {
return mField;
}
/** Returns default width type of the address field. */
WidthType getDefaulWidthType() {
return this.equals(POSTAL_CODE) || this.equals(SORTING_CODE)
? WidthType.SHORT : WidthType.LONG;
}
}
|