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.OBJECTWITHPATH ((CLASSPATH, CLASS) | (INSTANCEPATH, INSTANCE))
57   */
58  public class ValueObjectWithPathNode extends AbstractScalarValueNode {
59  	// ObjectPath element
60  	private String iPathNodeNameEnum;
61  
62  	private CIMObjectPath iObjPath;
63  
64  	// CIMObject element
65  	private String iObjNodeNameEnum;
66  
67  	private CIMNamedElementInterface iCIMObj;
68  
69  	/**
70  	 * Ctor.
71  	 */
72  	public ValueObjectWithPathNode() {
73  		super(VALUE_OBJECTWITHPATH);
74  	}
75  
76  	/**
77  	 * @param pAttribs
78  	 * @param pSession
79  	 */
80  	@Override
81  	public void init(Attributes pAttribs, SAXSession pSession) {
82  		this.iPathNodeNameEnum = this.iObjNodeNameEnum = null;
83  		this.iObjPath = null;
84  		this.iCIMObj = null;
85  		// no attributes
86  	}
87  
88  	/**
89  	 * @param pData
90  	 */
91  	@Override
92  	public void parseData(String pData) {
93  		// no data
94  	}
95  
96  	@Override
97  	public void testChild(String pNodeNameEnum) throws SAXException {
98  		if (pNodeNameEnum == CLASSPATH) {
99  			if (this.iPathNodeNameEnum != null) duplicatedNode(this.iPathNodeNameEnum, CLASSPATH);
100 			if (this.iObjNodeNameEnum == INSTANCE) illegalChildNodePair(CLASSPATH, INSTANCE);
101 		} else if (pNodeNameEnum == CLASS) {
102 			if (this.iObjNodeNameEnum != null) duplicatedNode(this.iObjNodeNameEnum, CLASS);
103 			if (this.iPathNodeNameEnum == INSTANCEPATH) illegalChildNodePair(INSTANCEPATH, CLASS);
104 		} else if (pNodeNameEnum == INSTANCEPATH) {
105 			if (this.iPathNodeNameEnum != null) duplicatedNode(this.iPathNodeNameEnum, INSTANCEPATH);
106 			if (this.iObjNodeNameEnum == CLASS) illegalChildNodePair(INSTANCEPATH, CLASS);
107 		} else if (pNodeNameEnum == INSTANCE) {
108 			if (this.iObjNodeNameEnum != null) duplicatedNode(this.iObjNodeNameEnum, INSTANCE);
109 			if (this.iPathNodeNameEnum == CLASSPATH) illegalChildNodePair(CLASSPATH, INSTANCE);
110 		} else throw new SAXException(getNodeName() + " node cannot have " + pNodeNameEnum + " child!");
111 	}
112 
113 	@Override
114 	public void childParsed(Node pChild) throws SAXException {
115 		if (pChild instanceof AbstractObjectPathNode) {
116 			this.iPathNodeNameEnum = pChild.getNodeName();
117 			this.iObjPath = ((AbstractObjectPathNode) pChild).getCIMObjectPath();
118 		} else { // ClassNode or InstanceNode, iObjPath must be available
119 			// here
120 			this.iObjNodeNameEnum = pChild.getNodeName();
121 			if (this.iPathNodeNameEnum == null) throw new SAXException(
122 				getNodeName() + " first child should contain an object path!"
123 			);
124 			if (pChild instanceof ClassNode) {
125 				this.iCIMObj = ((ClassNode) pChild).getCIMClass(this.iObjPath);
126 			} else {
127 				this.iCIMObj = ((InstanceNode) pChild).getCIMInstance(this.iObjPath);
128 			}
129 		}
130 	}
131 
132 	@Override
133 	public void testCompletness() throws SAXException {
134 		if (this.iPathNodeNameEnum == null) throw new SAXException(
135 			getNodeName() + " node must have a CLASSPATH or a INSTANCEPATH child node!"
136 		);
137 		if (this.iObjNodeNameEnum == null) throw new SAXException(
138 			getNodeName() + " node must have a CLASS or INSTANCE child node!"
139 		);
140 	}
141 
142 	/**
143 	 * @see ValueIf#getValue()
144 	 * @return CIMClass or CIMInstance
145 	 */
146 	public Object getValue() {
147 		return this.iCIMObj;
148 	}
149 
150 	public CIMDataType getType() {
151 		if (this.iCIMObj instanceof CIMClass) return CIMDataType.CLASS_T;
152 		return CIMDataType.OBJECT_T;
153 	}
154 }