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 * 2763216 2009-04-14 blaschke-oss Code cleanup: visible spelling/grammar errors
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.sblim.cimclient.internal.cimxml.sax.SAXSession;
48 import org.metricshub.wbem.sblim.cimclient.internal.wbem.CIMError;
49 import org.xml.sax.Attributes;
50 import org.xml.sax.SAXException;
51
52 /**
53 * <pre>
54 * ELEMENT EXPMETHODRESPONSE (ERROR|IRETURNVALUE?)
55 * ATTLIST EXPMETHODRESPONSE
56 * %CIMName;
57 * </pre>
58 */
59 public class ExpMethodResponseNode extends Node implements ErrorIf, RetValPipeIf, NonVolatileIf {
60 private String iName;
61
62 private ErrorNode iErrorNode;
63
64 private IReturnValueNode iRetValNode;
65
66 /**
67 * Ctor.
68 */
69 public ExpMethodResponseNode() {
70 super(EXPMETHODRESPONSE);
71 }
72
73 public void addChild(Node pChild) {
74 if (pChild instanceof ErrorNode) this.iErrorNode = (ErrorNode) pChild; else this.iRetValNode =
75 (IReturnValueNode) pChild;
76 }
77
78 /**
79 * @param pSession
80 */
81 @Override
82 public void init(Attributes pAttribs, SAXSession pSession) throws SAXException {
83 this.iName = getCIMName(pAttribs);
84 this.iErrorNode = null;
85 this.iRetValNode = null;
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 == ERROR || pNodeNameEnum == IRETURNVALUE) {
99 Node node;
100 if (this.iErrorNode != null) node = this.iErrorNode; else if (this.iRetValNode != null) node =
101 this.iRetValNode; else node = null;
102 if (node != null) throw new SAXException(
103 pNodeNameEnum +
104 " child node is invalid for " +
105 getNodeName() +
106 " node, since it already has a " +
107 node.getNodeName() +
108 " child node!"
109 );
110 } else throw new SAXException(getNodeName() + " node cannot have " + pNodeNameEnum + " child node!");
111 }
112
113 /**
114 * @param pChild
115 */
116 @Override
117 public void childParsed(Node pChild) {
118 // nothing to do yet
119 }
120
121 @Override
122 public void testCompletness() {
123 // no mandatory child nodes
124 }
125
126 public CIMError getCIMError() {
127 return this.iErrorNode == null ? null : this.iErrorNode.getCIMError();
128 }
129
130 public int getReturnValueCount() {
131 return this.iRetValNode == null ? 0 : this.iRetValNode.getReturnValueCount();
132 }
133
134 public Object readReturnValue() {
135 return this.iRetValNode.readReturnValue();
136 }
137
138 /**
139 * getName
140 *
141 * @return String
142 */
143 public String getName() {
144 return this.iName;
145 }
146 }