/*
     (C) Copyright IBM Corp. 2006, 2009
   
     THIS FILE IS PROVIDED UNDER THE TERMS OF THE ECLIPSE PUBLIC LICENSE
     ("AGREEMENT"). ANY USE, REPRODUCTION OR DISTRIBUTION OF THIS FILE
     CONSTITUTES RECIPIENTS ACCEPTANCE OF THE AGREEMENT.
   
     You can obtain a current copy of the Eclipse Public License from
     http://www.opensource.org/licenses/eclipse-1.0.php
  
    @author : Endre Bak, ebak@de.ibm.com
   * 
   * Flag       Date        Prog         Description
   * -------------------------------------------------------------------------------
   * 1565892    2006-12-04  ebak         Make SBLIM client JSR48 compliant
   * 2003590    2008-06-30  blaschke-oss Change licensing from CPL to EPL
   * 2524131    2009-01-21  raman_arora  Upgrade client to JDK 1.5 (Phase 1)
   * 2797550    2009-06-01  raman_arora  JSR48 compliance - add Java Generics
   */
  
  package org.metricshub.wbem.sblim.cimclient.internal.cimxml;
  
  /*-
   * ╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲
   * WBEM Java Client
   * ჻჻჻჻჻჻
   * Copyright 2023 - 2025 MetricsHub
   * ჻჻჻჻჻჻
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
   *
   *      http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   * ╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱╲╱
   */
  
  import org.metricshub.wbem.javax.cim.CIMObjectPath;
  import org.metricshub.wbem.javax.cim.CIMProperty;
  
  /**
   * Class LocalPathBuilder helps CIM-XML parsers to build local CIMObjectPathes.
   */
  public class LocalPathBuilder {
  	private CIMObjectPath iBasePath;
  
  	/**
  	 * Ctor.
  	 *
  	 * @param pBasePath
  	 */
  	public LocalPathBuilder(CIMObjectPath pBasePath) {
  		this.iBasePath = pBasePath;
  	}
  
  	/**
  	 * getBasePath
  	 *
  	 * @return CIMObjectPath
  	 */
  	public CIMObjectPath getBasePath() {
  		return this.iBasePath;
  	}
  
  	/**
  	 * build
  	 *
  	 * @param pObjPathStr
  	 * @return CIMObjectPath
  	 */
  	public CIMObjectPath build(String pObjPathStr) {
  		return build(this.iBasePath, pObjPathStr);
  	}
  
  	/**
  	 * build
  	 *
  	 * @param pObjName
  	 * @param pNameSpace
  	 * @return CIMObjectPath
  	 */
  	public CIMObjectPath build(String pObjName, String pNameSpace) {
  		return build(this.iBasePath, pObjName, pNameSpace);
  	}
  
  	/**
  	 * build
  	 *
  	 * @param pObjName
  	 * @param pNameSpace
  	 * @param pKeys
  	 * @return CIMObjectPath
  	 */
  	public CIMObjectPath build(String pObjName, String pNameSpace, CIMProperty<?>[] pKeys) {
 		return build(this.iBasePath, pObjName, pNameSpace, pKeys);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pHost
 	 * @param pNameSpace
 	 * @param pObjName
 	 * @param pKeys
 	 * @return CIMObjectPath
 	 */
 	public CIMObjectPath build(String pHost, String pNameSpace, String pObjName, CIMProperty<?>[] pKeys) {
 		return build(this.iBasePath, pHost, pNameSpace, pObjName, pKeys);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pScheme
 	 * @param pHost
 	 * @param pPort
 	 * @param pNameSpace
 	 * @param pObjName
 	 * @param pKeys
 	 * @return CIMObjectPath
 	 */
 	public CIMObjectPath build(
 		String pScheme,
 		String pHost,
 		String pPort,
 		String pNameSpace,
 		String pObjName,
 		CIMProperty<?>[] pKeys
 	) {
 		return build(this.iBasePath, pScheme, pHost, pPort, pNameSpace, pObjName, pKeys);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pBasePath
 	 * @param pObjPathStr
 	 * @return CIMObjectPath
 	 */
 	public static CIMObjectPath build(CIMObjectPath pBasePath, String pObjPathStr) {
 		CIMObjectPath path = new CIMObjectPath(pObjPathStr);
 		return build(
 			pBasePath,
 			path.getScheme(),
 			path.getHost(),
 			path.getPort(),
 			path.getNamespace(),
 			path.getObjectName(),
 			path.getKeys()
 		);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pBasePath
 	 * @param pObjName
 	 * @param pNameSpace
 	 * @return CIMObjectPath
 	 */
 	public static CIMObjectPath build(CIMObjectPath pBasePath, String pObjName, String pNameSpace) {
 		return build(pBasePath, null, null, null, pNameSpace, pObjName, null);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pBasePath
 	 * @param pObjName
 	 * @param pNameSpace
 	 * @param pKeys
 	 * @return CIMObjectPath
 	 */
 	public static CIMObjectPath build(
 		CIMObjectPath pBasePath,
 		String pObjName,
 		String pNameSpace,
 		CIMProperty<?>[] pKeys
 	) {
 		return build(pBasePath, null, null, null, pNameSpace, pObjName, pKeys);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pBasePath
 	 * @param pHost
 	 * @param pNameSpace
 	 * @param pObjName
 	 * @param pKeys
 	 * @return CIMObjectPath
 	 */
 	public static CIMObjectPath build(
 		CIMObjectPath pBasePath,
 		String pHost,
 		String pNameSpace,
 		String pObjName,
 		CIMProperty<?>[] pKeys
 	) {
 		return build(pBasePath, null, pHost, null, pNameSpace, pObjName, pKeys);
 	}
 
 	/**
 	 * build
 	 *
 	 * @param pBasePath
 	 * @param pScheme
 	 * @param pHost
 	 * @param pPort
 	 * @param pNameSpace
 	 * @param pObjName
 	 * @param pKeys
 	 * @return CIMObjectPath
 	 */
 	public static CIMObjectPath build(
 		CIMObjectPath pBasePath,
 		String pScheme,
 		String pHost,
 		String pPort,
 		String pNameSpace,
 		String pObjName,
 		CIMProperty<?>[] pKeys
 	) {
 		if (pBasePath == null) return new CIMObjectPath(pScheme, pHost, pPort, pNameSpace, pObjName, pKeys);
 		return new CIMObjectPath(
 			pScheme == null ? pBasePath.getScheme() : pScheme,
 			pHost == null ? pBasePath.getHost() : pHost,
 			pPort == null ? pBasePath.getPort() : pPort,
 			pNameSpace == null ? pBasePath.getNamespace() : pNameSpace,
 			pObjName == null ? pBasePath.getObjectName() : pObjName,
 			pKeys // local
 			// objectpath shouldn't contain keys
 		);
 	}
 }