View Javadoc
1   /*
2    * Portions of this software was developed by employees of the National Institute
3    * of Standards and Technology (NIST), an agency of the Federal Government and is
4    * being made available as a public service. Pursuant to title 17 United States
5    * Code Section 105, works of NIST employees are not subject to copyright
6    * protection in the United States. This software may be subject to foreign
7    * copyright. Permission in the United States and in foreign countries, to the
8    * extent that NIST may hold copyright, to use, copy, modify, create derivative
9    * works, and distribute this software and its documentation without fee is hereby
10   * granted on a non-exclusive basis, provided that this notice and disclaimer
11   * of warranty appears in all copies.
12   *
13   * THE SOFTWARE IS PROVIDED 'AS IS' WITHOUT ANY WARRANTY OF ANY KIND, EITHER
14   * EXPRESSED, IMPLIED, OR STATUTORY, INCLUDING, BUT NOT LIMITED TO, ANY WARRANTY
15   * THAT THE SOFTWARE WILL CONFORM TO SPECIFICATIONS, ANY IMPLIED WARRANTIES OF
16   * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND FREEDOM FROM
17   * INFRINGEMENT, AND ANY WARRANTY THAT THE DOCUMENTATION WILL CONFORM TO THE
18   * SOFTWARE, OR ANY WARRANTY THAT THE SOFTWARE WILL BE ERROR FREE.  IN NO EVENT
19   * SHALL NIST BE LIABLE FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO, DIRECT,
20   * INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES, ARISING OUT OF, RESULTING FROM,
21   * OR IN ANY WAY CONNECTED WITH THIS SOFTWARE, WHETHER OR NOT BASED UPON WARRANTY,
22   * CONTRACT, TORT, OR OTHERWISE, WHETHER OR NOT INJURY WAS SUSTAINED BY PERSONS OR
23   * PROPERTY OR OTHERWISE, AND WHETHER OR NOT LOSS WAS SUSTAINED FROM, OR AROSE OUT
24   * OF THE RESULTS OF, OR USE OF, THE SOFTWARE OR SERVICES PROVIDED HEREUNDER.
25   */
26  
27  package gov.nist.secauto.metaschema.databind.model;
28  
29  import gov.nist.secauto.metaschema.core.datatype.IDataTypeAdapter;
30  import gov.nist.secauto.metaschema.core.datatype.markup.MarkupLine;
31  import gov.nist.secauto.metaschema.core.datatype.markup.MarkupMultiline;
32  import gov.nist.secauto.metaschema.core.model.ModelType;
33  import gov.nist.secauto.metaschema.core.util.ObjectUtils;
34  import gov.nist.secauto.metaschema.databind.model.annotations.MetaschemaFieldValue;
35  
36  import java.lang.reflect.Field;
37  
38  import edu.umd.cs.findbugs.annotations.NonNull;
39  import edu.umd.cs.findbugs.annotations.Nullable;
40  
41  class DefaultFieldValueProperty
42      extends AbstractProperty<IFieldClassBinding>
43      implements IBoundFieldValueInstance {
44    @NonNull
45    private final Field field;
46    @NonNull
47    private final MetaschemaFieldValue fieldValue;
48    @NonNull
49    private final IDataTypeAdapter<?> javaTypeAdapter;
50    @Nullable
51    private final Object defaultValue;
52  
53    @SuppressWarnings("PMD.ConstructorCallsOverridableMethod")
54    public DefaultFieldValueProperty(
55        @NonNull IFieldClassBinding fieldClassBinding,
56        @NonNull Field field) {
57      super(fieldClassBinding);
58      this.field = ObjectUtils.requireNonNull(field, "field");
59      MetaschemaFieldValue valueAnnotation = field.getAnnotation(MetaschemaFieldValue.class);
60      if (valueAnnotation == null) {
61        throw new IllegalArgumentException(
62            String.format("Class '%s' is missing the '%s' annotation.",
63                fieldClassBinding.getBoundClass().getName(),
64                MetaschemaFieldValue.class.getName()));
65      }
66      this.fieldValue = valueAnnotation;
67  
68      Class<? extends IDataTypeAdapter<?>> adapterClass = ObjectUtils.notNull(fieldValue.typeAdapter());
69      this.javaTypeAdapter = ModelUtil.getDataTypeAdapter(adapterClass, fieldClassBinding.getBindingContext());
70      this.defaultValue = ModelUtil.resolveDefaultValue(getFieldValueAnnotation().defaultValue(), this.javaTypeAdapter);
71    }
72  
73    @Override
74    public Field getField() {
75      return field;
76    }
77  
78    @Override
79    public Object getDefaultValue() {
80      return defaultValue;
81    }
82  
83    @NonNull
84    private MetaschemaFieldValue getFieldValueAnnotation() {
85      return fieldValue;
86    }
87  
88    @Override
89    public IFieldClassBinding getDefinition() {
90      return getParentClassBinding();
91    }
92  
93    @Override
94    public String getJsonValueKeyName() {
95      String name = ModelUtil.resolveToString(getFieldValueAnnotation().valueKeyName());
96      if (name == null) {
97        name = getJavaTypeAdapter().getDefaultJsonValueKey();
98      }
99      return name;
100   }
101 
102   @Override
103   public IDataTypeAdapter<?> getJavaTypeAdapter() {
104     return javaTypeAdapter;
105   }
106 
107   @Override
108   public String getFormalName() {
109     // a field value doesn't have a formal name
110     return null;
111   }
112 
113   @Override
114   public MarkupLine getDescription() {
115     // a field value doesn't have a formal name
116     return null;
117   }
118 
119   @Override
120   public MarkupMultiline getRemarks() {
121     // a field value doesn't have a formal name
122     return null;
123   }
124 
125   @Override
126   public String getName() {
127     return getJsonValueKeyName();
128   }
129 
130   @Override
131   public String getUseName() {
132     // TODO: implement?
133     return null;
134   }
135 
136   @Override
137   public @NonNull ModelType getModelType() {
138     // TODO: is this right? Is there a way to not make this derived from a property?
139     return ModelType.FIELD;
140   }
141 
142   @Override
143   public void copyBoundObject(Object fromInstance, Object toInstance) {
144     Object value = getValue(fromInstance);
145     IDataTypeAdapter<?> adapter = getJavaTypeAdapter();
146     setValue(toInstance, value == null ? null : adapter.copy(value));
147   }
148 
149   @Override
150   public Object defaultValue() {
151     return getDefaultValue();
152   }
153 }