1 /**
2 * Copyright 2005-2011 The Kuali Foundation
3 *
4 * Licensed under the Educational Community License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
7 *
8 * http://www.opensource.org/licenses/ecl2.php
9 *
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
15 */
16 package org.kuali.rice.kim.api.identity.phone;
17
18 import org.kuali.rice.core.api.mo.common.Defaultable;
19 import org.kuali.rice.core.api.mo.common.GloballyUnique;
20 import org.kuali.rice.core.api.mo.common.Identifiable;
21 import org.kuali.rice.core.api.mo.common.Versioned;
22 import org.kuali.rice.core.api.mo.common.active.Inactivatable;
23 import org.kuali.rice.kim.api.identity.CodedAttributeContract;
24
25 public interface EntityPhoneContract extends Versioned, GloballyUnique, Defaultable, Inactivatable, Identifiable {
26
27 /**
28 * Gets this id of the parent identity object.
29 * @return the identity id for this {@link EntityPhoneContract}
30 */
31 String getEntityId();
32
33 /**
34 * Gets this entityTypeCode of the {@link EntityPhoneContract}'s object.
35 * @return the identity type code for this {@link EntityPhoneContract}
36 */
37 String getEntityTypeCode();
38
39 /**
40 * Gets this {@link EntityPhone}'s type code.
41 * @return the type code for this {@link EntityPhone}, or null if none has been assigned.
42 */
43 CodedAttributeContract getPhoneType();
44
45 /**
46 * Gets this {@link EntityPhone}'s phone number.
47 * @return the phone number for this {@link EntityPhone}, or null if none has been assigned.
48 */
49 String getPhoneNumber();
50
51 /**
52 * Gets this {@link EntityPhone}'s extension number.
53 * @return the extension number for this {@link EntityPhone}, or null if none has been assigned.
54 */
55 String getExtensionNumber();
56
57 /**
58 * Gets this {@link EntityPhone}'s country code.
59 * @return the country code for this {@link EntityPhone}, or null if none has been assigned.
60 */
61 String getCountryCode();
62
63 /**
64 * Gets this {@link EntityPhone}'s unmasked phone number.
65 * @return the unmasked phone number for this {@link EntityPhone}, or null if none has been assigned.
66 */
67 String getPhoneNumberUnmasked();
68
69 /**
70 * Gets this {@link EntityPhone}'s unmasked extension number.
71 * @return the unmasked extension number for this {@link EntityPhone}, or null if none has been assigned.
72 */
73 String getExtensionNumberUnmasked();
74
75 /**
76 * Gets this {@link EntityPhone}'s unmasked country code.
77 * @return the unmasked country code for this {@link EntityPhone}, or null if none has been assigned.
78 */
79 String getCountryCodeUnmasked();
80
81 /**
82 * Gets this {@link EntityPhone}'s formatted phone number.
83 * @return the formatted phone number for this {@link EntityPhone}, or null if none has been assigned.
84 */
85 String getFormattedPhoneNumber();
86
87 /**
88 * Gets this {@link EntityPhone}'s unmasked formatted phone number.
89 * @return the unmasked formatted phone number for this {@link EntityPhone}, or null if none has been assigned.
90 */
91 String getFormattedPhoneNumberUnmasked();
92
93 /**
94 * Returns a boolean value that determines if phone fields should be suppressed.
95 * @return boolean value that determines if phone should be suppressed.
96 */
97 boolean isSuppressPhone();
98 }