1 | // License: GPL. For details, see LICENSE file.
|
---|
2 | package org.openstreetmap.josm.tools;
|
---|
3 |
|
---|
4 | import java.util.Objects;
|
---|
5 | import java.util.Set;
|
---|
6 |
|
---|
7 | /**
|
---|
8 | * Describes a regional Taginfo instance.
|
---|
9 | * @since 15876
|
---|
10 | */
|
---|
11 | public class TaginfoRegionalInstance {
|
---|
12 |
|
---|
13 | /** Instance URL */
|
---|
14 | private final String url;
|
---|
15 | /** Set of ISO3166 codes for the covered areas */
|
---|
16 | private final Set<String> isoCodes;
|
---|
17 | /** Optional suffix to distinguish them in UI */
|
---|
18 | private final String suffix;
|
---|
19 |
|
---|
20 | /**
|
---|
21 | * Constructs a new {@code TaginfoRegionalInstance}.
|
---|
22 | * @param url Instance URL. Must not be null
|
---|
23 | * @param isoCodes Set of ISO3166 codes for the covered areas. Must not be null
|
---|
24 | */
|
---|
25 | public TaginfoRegionalInstance(String url, Set<String> isoCodes) {
|
---|
26 | this(url, isoCodes, null);
|
---|
27 | }
|
---|
28 |
|
---|
29 | /**
|
---|
30 | * Constructs a new {@code TaginfoRegionalInstance}.
|
---|
31 | * @param url Instance URL. Must not be null
|
---|
32 | * @param isoCodes Set of ISO3166 codes for the covered areas. Must not be null
|
---|
33 | * @param suffix Optional suffix to distinguish them in UI. Can be null
|
---|
34 | */
|
---|
35 | public TaginfoRegionalInstance(String url, Set<String> isoCodes, String suffix) {
|
---|
36 | this.url = Objects.requireNonNull(url);
|
---|
37 | this.isoCodes = Objects.requireNonNull(isoCodes);
|
---|
38 | this.suffix = suffix;
|
---|
39 | }
|
---|
40 |
|
---|
41 | /**
|
---|
42 | * Returns the instance URL.
|
---|
43 | * @return instance URL
|
---|
44 | */
|
---|
45 | public String getUrl() {
|
---|
46 | return url;
|
---|
47 | }
|
---|
48 |
|
---|
49 | /**
|
---|
50 | * Returns the set of ISO3166 codes for the covered areas.
|
---|
51 | * @return set of ISO3166 codes for the covered areas
|
---|
52 | */
|
---|
53 | public Set<String> getIsoCodes() {
|
---|
54 | return isoCodes;
|
---|
55 | }
|
---|
56 |
|
---|
57 | /**
|
---|
58 | * Returns the optional suffix to distinguish them in UI.
|
---|
59 | * @return optional suffix to distinguish them in UI. Can be null
|
---|
60 | */
|
---|
61 | public String getSuffix() {
|
---|
62 | return suffix;
|
---|
63 | }
|
---|
64 |
|
---|
65 | @Override
|
---|
66 | public String toString() {
|
---|
67 | return (suffix == null ? "" : suffix + " ") + String.join("/", isoCodes);
|
---|
68 | }
|
---|
69 | }
|
---|