View Javadoc
1   /*
2     (C) Copyright IBM Corp. 2006, 2012
3   
4     THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE
5     ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE
6     CONSTITUTES RECIPIENTS ACCEPTANCE OF THE AGREEMENT.
7   
8     You can obtain a current copy of the Eclipse Public License from
9     http://www.opensource.org/licenses/eclipse-1.0.php
10  
11    @author : Endre Bak, ebak@de.ibm.com
12   * 
13   * Flag       Date        Prog         Description
14   * -------------------------------------------------------------------------------
15   * 1565892    2006-12-04  ebak         Make SBLIM client JSR48 compliant
16   * 1663270    2007-02-19  ebak         Minor performance problems
17   * 1660756    2007-02-22  ebak         Embedded object support
18   * 1720707    2007-05-17  ebak         Conventional Node factory for CIM-XML SAX parser
19   * 2003590    2008-06-30  blaschke-oss Change licensing from CPL to EPL
20   * 2524131    2009-01-21  raman_arora  Upgrade client to JDK 1.5 (Phase 1)
21   * 2531371    2009-02-10  raman_arora  Upgrade client to JDK 1.5 (Phase 2)
22   * 3511454    2012-03-27  blaschke-oss SAX nodes not reinitialized properly
23   */
24  
25  package org.metricshub.wbem.sblim.cimclient.internal.cimxml.sax.node;
26  
27  /*-
28   * ╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲
29   * WBEM Java Client
30   * ჻჻჻჻჻჻
31   * Copyright 2023 - 2025 MetricsHub
32   * ჻჻჻჻჻჻
33   * Licensed under the Apache License, Version 2.0 (the "License");
34   * you may not use this file except in compliance with the License.
35   * You may obtain a copy of the License at
36   *
37   *      http://www.apache.org/licenses/LICENSE-2.0
38   *
39   * Unless required by applicable law or agreed to in writing, software
40   * distributed under the License is distributed on an "AS IS" BASIS,
41   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
42   * See the License for the specific language governing permissions and
43   * limitations under the License.
44   * ╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱
45   */
46  
47  import org.metricshub.wbem.javax.cim.CIMClass;
48  import org.metricshub.wbem.javax.cim.CIMDataType;
49  import org.metricshub.wbem.javax.cim.CIMNamedElementInterface;
50  import org.metricshub.wbem.javax.cim.CIMObjectPath;
51  import org.metricshub.wbem.sblim.cimclient.internal.cimxml.sax.SAXSession;
52  import org.xml.sax.Attributes;
53  import org.xml.sax.SAXException;
54  
55  /**
56   * ELEMENT VALUE.OBJECTWITHLOCALPATH ((LOCALCLASSPATH, CLASS) |
57   * (LOCALINSTANCEPATH, INSTANCE))
58   */
59  public class ValueObjectWithLocalPathNode extends AbstractScalarValueNode {
60  	// ObjectPath element
61  	private String iPathNodeNameEnum;
62  
63  	private CIMObjectPath iObjPath;
64  
65  	// Object element
66  	private String iObjNodeNameEnum;
67  
68  	private CIMNamedElementInterface iCIMObj;
69  
70  	/**
71  	 * Ctor.
72  	 */
73  	public ValueObjectWithLocalPathNode() {
74  		super(VALUE_OBJECTWITHLOCALPATH);
75  	}
76  
77  	/**
78  	 * @param pAttribs
79  	 * @param pSession
80  	 */
81  	@Override
82  	public void init(Attributes pAttribs, SAXSession pSession) {
83  		this.iPathNodeNameEnum = this.iObjNodeNameEnum = null;
84  		this.iObjPath = null;
85  		this.iCIMObj = null;
86  		// no attributes
87  	}
88  
89  	/**
90  	 * @param pData
91  	 */
92  	@Override
93  	public void parseData(String pData) {
94  		// no data
95  	}
96  
97  	@Override
98  	public void testChild(String pNodeNameEnum) throws SAXException {
99  		if (pNodeNameEnum == LOCALCLASSPATH) {
100 			if (this.iPathNodeNameEnum != null) duplicatedNode(this.iPathNodeNameEnum, LOCALCLASSPATH);
101 			if (this.iObjNodeNameEnum == INSTANCE) illegalChildNodePair(LOCALCLASSPATH, INSTANCE);
102 		} else if (pNodeNameEnum == CLASS) {
103 			if (this.iObjNodeNameEnum != null) duplicatedNode(this.iObjNodeNameEnum, CLASS);
104 			if (this.iPathNodeNameEnum == LOCALINSTANCEPATH) illegalChildNodePair(LOCALINSTANCEPATH, CLASS);
105 		} else if (pNodeNameEnum == LOCALINSTANCEPATH) {
106 			if (this.iPathNodeNameEnum != null) duplicatedNode(this.iPathNodeNameEnum, LOCALINSTANCEPATH);
107 			if (this.iObjNodeNameEnum == CLASS) illegalChildNodePair(LOCALINSTANCEPATH, CLASS);
108 		} else if (pNodeNameEnum == INSTANCE) {
109 			if (this.iObjNodeNameEnum != null) duplicatedNode(this.iObjNodeNameEnum, INSTANCE);
110 			if (this.iPathNodeNameEnum == LOCALCLASSPATH) illegalChildNodePair(LOCALCLASSPATH, INSTANCE);
111 		} else throw new SAXException(getNodeName() + " node cannot have " + pNodeNameEnum + " child!");
112 	}
113 
114 	@Override
115 	public void childParsed(Node pChild) throws SAXException {
116 		if (pChild instanceof AbstractObjectPathNode) {
117 			this.iPathNodeNameEnum = pChild.getNodeName();
118 			this.iObjPath = ((AbstractObjectPathNode) pChild).getCIMObjectPath();
119 		} else { // ClassNode or InstanceNode, iObjPath must be available
120 			// here
121 			this.iObjNodeNameEnum = pChild.getNodeName();
122 			if (this.iPathNodeNameEnum == null) throw new SAXException(
123 				getNodeName() + " first child should contain an object path!"
124 			);
125 			if (pChild instanceof ClassNode) {
126 				this.iCIMObj = ((ClassNode) pChild).getCIMClass(this.iObjPath);
127 			} else {
128 				this.iCIMObj = ((InstanceNode) pChild).getCIMInstance(this.iObjPath);
129 			}
130 		}
131 	}
132 
133 	@Override
134 	public void testCompletness() throws SAXException {
135 		if (this.iPathNodeNameEnum == null) throw new SAXException(
136 			getNodeName() + " node must have a LOCALCLASSPATH or a LOCALINSTANCEPATH child node!"
137 		);
138 		if (this.iObjNodeNameEnum == null) throw new SAXException(
139 			getNodeName() + " node must have a CLASS or INSTANCE child node!"
140 		);
141 	}
142 
143 	/**
144 	 * @see ValueIf#getValue()
145 	 * @return CIMClass or CIMInstance
146 	 */
147 	public Object getValue() {
148 		return this.iCIMObj;
149 	}
150 
151 	public CIMDataType getType() {
152 		if (this.iCIMObj instanceof CIMClass) return CIMDataType.CLASS_T;
153 		return CIMDataType.OBJECT_T;
154 	}
155 }