com.sap.psr.vulas.java.JavaClassId Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of lang-java Show documentation
There is a newer version: 3.1.15
/**
 * This file is part of Eclipse Steady.
 *
 * 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.
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Copyright (c) 2018 SAP SE or an SAP affiliate company. All rights reserved.
 */
package com.sap.psr.vulas.java;

import com.sap.psr.vulas.ConstructId;


/**
 * Identifies a Java class (normal or nested).
 */
public class JavaClassId extends JavaId {
	
	private JavaId declarationContext = null;
	private String className = null;
	
	/**
	 * Constructor for creating the identifier of a nested class.
	 *
	 * @param _declaration_ctx a {@link com.sap.psr.vulas.java.JavaId} object.
	 * @param _simple_name a {@link java.lang.String} object.
	 */
	public JavaClassId(JavaId _declaration_ctx, String _simple_name) {
		//super( (_declaration_ctx.getType().equals(JavaId.Type.PACKAGE) ? JavaId.Type.CLASS : JavaId.Type.NESTED_CLASS) );
		super( JavaId.Type.CLASS );
		this.declarationContext = _declaration_ctx;
		this.className = _simple_name;
	}
	
	/**
	 * isNestedClass.
	 *
	 * @return a boolean.
	 */
	public boolean isNestedClass() {
		return this.declarationContext!=null && !this.declarationContext.getType().equals(JavaId.Type.PACKAGE);
	}
	
	/**
	 * {@inheritDoc}
	 *
	 * Returns the fully qualified class name, i.e., including the name of the package in which the class is defined.
	 */
	@Override
	public String getQualifiedName() {
		final StringBuilder builder = new StringBuilder();
		if(this.declarationContext!=null) {
			final String prefix = this.declarationContext.getQualifiedName();
			builder.append(prefix); // Empty string in case of default package			
			// Outer class
			if(!this.isNestedClass()) {
				if(!prefix.equals("")) // Could also use JavaPackageId.isDefaultPackage
					builder.append(".");
			}
			// Inner class
			else {
				if(!prefix.equals("")) // Should probably never happen
					builder.append("$");
			}
		}
		builder.append(this.className);
		return builder.toString();
	}
	
	/**
	 * {@inheritDoc}
	 *
	 * Returns a class name that is unique within the package in which the class is defined.
	 * In case of nested classes, the names of parent classes will be included (e.g., OuterClass$InnerClass).
	 * @return the class name including the names of parent classes (if any)
	 */
	@Override
	public String getName() {
		if(this.declarationContext!=null) {
			if(!this.isNestedClass())
				return this.className;
			else
				return this.declarationContext.getName() + "$" + this.className;
		} else {
			return this.className;
		}
	}
	
	/**
	 * {@inheritDoc}
	 *
	 * Returns the class name without considering any context.
	 * @return the simple class name w/o context information
	 */
	@Override
	public String getSimpleName() { return this.className; }
	
	/**
	 * {@inheritDoc}
	 *
	 * Returns the name of the Java package in which the class or nested class is defined. Returns null if a class is defined outside of a package.
	 * @return a Java package name
	 */
	@Override
	public ConstructId getDefinitionContext() {
		return this.declarationContext;
		//return this.getJavaPackageId();
	}
	
	/**
	 * {@inheritDoc}
	 *
	 * Returns the Java package in the context of which the construct is defined.
	 */
	@Override
	public JavaPackageId getJavaPackageId() {
		if(this.isNestedClass())
			return this.declarationContext.getJavaPackageId();
		else
			return (JavaPackageId)this.declarationContext;
	}
	
	/**
	 * getClassInit.
	 *
	 * @return a {@link com.sap.psr.vulas.java.JavaClassInit} object.
	 */
	public JavaClassInit getClassInit() {
		return new JavaClassInit(this);
	}
	
	/**
	 * isTestClass.
	 *
	 * @return a boolean.
	 */
	public boolean isTestClass() {
		return this.className.toLowerCase().startsWith("test") || this.className.toLowerCase().endsWith("test");
	}
        
}