src/main/java/com/p4square/ccbapi/model/Country.java


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

package com.p4square.ccbapi.model;

import javax.xml.bind.annotation.*;

/**
 * Country code and name pair.
 */
@XmlRootElement(name="country")
@XmlAccessorType(XmlAccessType.NONE)
public class Country {

    @XmlAttribute(name="code")
    private String code;

    @XmlValue
    private String name;

    /**
     * @return The two letter country code.
     */
    public String getCountryCode() {
        return code;
    }

    /**
     * Set the two letter country code.
     *
     * This class does not attempt to resolve the country name from the country code.
     * When the country code is set the name will become null.

     * @param code A two letter countey code.
     * @throws IllegalArgumentException if the country code is not valid.
     */
    public void setCountryCode(final String code) {
        if (code.length() != 2) {
            throw new IllegalArgumentException("Argument must be a two letter country code.");
        }
        this.code = code.toUpperCase();
        this.name = null;
    }

    /**
     * @return The country name or null if the country name is unknown.
     */
    public String getName() {
        return name;
    }
}