Class Address
- All Implemented Interfaces:
Serializable
You can either set street, house number, postal code and town (type structured address) or address line 1 and 2 (type combined address elements). The type is automatically set once any of these fields is set. Before setting the fields, the address type is undetermined. If fields of both types are set, the address type becomes conflicting. Name and country code must always be set unless all fields are empty.
- See Also:
-
Nested Class Summary
Nested Classes -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidclear()Clears all fields and set the type toAddress.Type.UNDETERMINED.booleanGets the address line 1Gets the address line 2Gets the two-letter ISO country code.Gets the house or building number.getName()Gets the name, either the first and last name of a natural person or the company name of a legal person.Gets the postal codeGets the street.getTown()Gets the town.getType()Gets the address type.inthashCode()voidsetAddressLine1(String addressLine1) Sets the address line 1.voidsetAddressLine2(String addressLine2) Sets the address line 2.voidsetCountryCode(String countryCode) Sets the two-letter ISO country codevoidsetHouseNo(String houseNo) Sets the house or building number.voidSets the name, either the first and last name of a natural person or the company name of a legal person.voidsetPostalCode(String postalCode) Sets the postal codevoidSets the street.voidSets the towntoString()
-
Constructor Details
-
Address
public Address()
-
-
Method Details
-
getType
Gets the address type.The address type is automatically set by either setting street / house number or address line 1 and 2. Before setting the fields, the address type is undetermined. If fields of both types are set, the address type becomes conflicting.
The address type can be reset by calling
clear().- Returns:
- address type
-
getName
Gets the name, either the first and last name of a natural person or the company name of a legal person.- Returns:
- the name
-
setName
Sets the name, either the first and last name of a natural person or the company name of a legal person.The name is mandatory unless the entire address contains
nullor empty values.- Parameters:
name- the name
-
getAddressLine1
Gets the address line 1Address line 1 contains street name, house number or P.O. box.
This field is only used for combined elements addresses and is optional.
- Returns:
- address line 1
-
setAddressLine1
Sets the address line 1.Address line 1 contains street name, house number or P.O. box.
Setting this field sets the address type to
Address.Type.COMBINED_ELEMENTSunless it's alreadyAddress.Type.STRUCTURED, in which case it becomesAddress.Type.CONFLICTING.This field is only used for combined elements addresses and is optional.
- Parameters:
addressLine1- address line 1
-
getAddressLine2
Gets the address line 2Address line 2 contains postal code and town.
This field is only used for combined elements addresses. For this type, it's mandatory.
- Returns:
- address line 2
-
setAddressLine2
Sets the address line 2.Address line 2 contains postal code and town
Setting this field sets the address type to
Address.Type.COMBINED_ELEMENTSunless it's alreadyAddress.Type.STRUCTURED, in which case it becomesAddress.Type.CONFLICTING.This field is only used for combined elements addresses. For this type, it's mandatory.
- Parameters:
addressLine2- address line 2
-
getStreet
Gets the street.This field is only used for structured addresses and is optional.
- Returns:
- the street
-
setStreet
Sets the street.This field must not contain the house or building number.
Setting this field sets the address type to
Address.Type.STRUCTUREDunless it's alreadyAddress.Type.COMBINED_ELEMENTS, in which case it becomesAddress.Type.CONFLICTING.This field is only used for structured addresses and is optional.
- Parameters:
street- the street
-
getHouseNo
Gets the house or building number.This field is only used for structured addresses and is optional.
- Returns:
- the house number
-
setHouseNo
Sets the house or building number.Setting this field sets the address type to
Address.Type.STRUCTUREDunless it's alreadyAddress.Type.COMBINED_ELEMENTS, in which case it becomesAddress.Type.CONFLICTING.This field is only used for structured addresses and is optional.
- Parameters:
houseNo- the house number
-
getPostalCode
Gets the postal codeThis field is only used for structured addresses. For this type, it's mandatory.
- Returns:
- the postal code
-
setPostalCode
Sets the postal codeSetting this field sets the address type to
Address.Type.STRUCTUREDunless it's alreadyAddress.Type.COMBINED_ELEMENTS, in which case it becomesAddress.Type.CONFLICTING.This field is only used for structured addresses. For this type, it's mandatory.
- Parameters:
postalCode- the postal code
-
getTown
Gets the town.This field is only used for structured addresses. For this type, it's mandatory.
- Returns:
- the town
-
setTown
Sets the townSetting this field sets the address type to
Address.Type.STRUCTUREDunless it's alreadyAddress.Type.COMBINED_ELEMENTS, in which case it becomesAddress.Type.CONFLICTING.This field is only used for structured addresses. For this type, it's mandatory.
- Parameters:
town- the town
-
getCountryCode
Gets the two-letter ISO country code.- Returns:
- the ISO country code
-
setCountryCode
Sets the two-letter ISO country codeThe country code is mandatory unless the entire address contains
nullor empty values.- Parameters:
countryCode- the ISO country code
-
clear
public void clear()Clears all fields and set the type toAddress.Type.UNDETERMINED. -
equals
-
hashCode
public int hashCode() -
toString
-