deprecated

1. 개요

2. 원인

3. 언어별 상세

3.1. C++

#!syntax cpp
// 변수 deprecate하기
[[deprecated]]
int deprecated_variable;

// 함수 deprecate하기
[[deprecated]]
void deprecated_function([[deprecated]] int deprecated_parameter) {} // 함수 파라미터 deprecate하기

// 타입 정의 deprecate하기
[[deprecated]]
typedef int deprecated_typedef;

// 클래스, 구조체, enum 등 deprecate하기
class [[deprecated]] deprecated_class {
	public:
		// 멤버 및 메서드 deprecate하기
		[[deprecated]] int deprecated_member;
};

// deprecate 사유 추가하기
[[deprecated("본 함수는 다음과 같은 이유로 사용이 권장되지 않습니다.")]]
void deprecated_function2() {}
// warning: 'deprecated_function2' is deprecated: 본 함수는 다음과 같은 이유로 사용이 권장되지 않습니다.

3.2. Java

#!syntax java
// Java deprecate 예시
public class Example {
	// 변수 deprecate
	/**
	 * @deprecated
	 * 해당 변수는 더 이상 사용되지 않습니다. {@link newVariable}을 사용하세요.
	 */
	@Deprecated
	public static final String deprecatedVariable = "사용되지 않는 변수";
	public static final String newVariable = "새로운 변수";

	// 메서드 deprecate
	/**
	 * @deprecated
	 * 해당 메서드는 더 이상 사용되지 않습니다. {@link #newMethod()}을 사용하세요.
	 */
	@Deprecated
	public void deprecatedMethod() {
		System.out.println("사용되지 않는 메서드");
	}
	public void newMethod() {
		System.out.println("새로운 메서드");
	}

	// 클래스 deprecate
	/**
	 * @deprecated
	 * 해당 클래스는 더 이상 사용되지 않습니다. {@link newClass}을 사용하세요.
	 */
	@Deprecated
	public static class deprecatedClass {
		public void doSomething() {
            System.out.println("사용되지 않는 클래스");
        }
	}
	public static class newClass {
		public void doSomething() {
            System.out.println("새로운 클래스");
        }
	}

	// 열거형 depreacte
	/**
	 * @deprecated
	 * 해당 열거형은 더 이상 사용되지 않습니다. {@link NewEnum}을 사용하세요.
	 */
	@Deprecated
	public enum DeprecatedEnum {
		// 열거형 상수 deprecate
		/**
	 	 * @deprecated
	 	 * 해당 열거형 상수는 더 이상 사용되지 않습니다. {@link NEW_VALUE}을 사용하세요.
	 	 */
		@Deprecated
		DEPRECATED_VALUE,
		NEW_VALUE;
	}
	public enum NewEnum {
		NEW_VALUE;
	}
}

#!syntax java
/**
 * @deprecated 
 * 해당 메서드는 버전 1.5 이후로 더 이상 사용되지 않으며 삭제될 예정입니다. {@link #newMethod}를 사용하세요.
 */
@Deprecated(since = "1.5", forRemoval = true)
public void deprecatedMethod() {
	System.out.println("사용되지 않는 메서드");
}
public void newMethod() {
	System.out.println("새로운 메서드");
}

4. 유명한 예시

• PHP에서 5.3에 deprecated를 도입했는데, 이 때문에 PHP 5.3 이상에서 제로보드를 설치 시 설치 화면에 deprecated 범벅이 되는 사태가 발생했었다. 제로보드가 PHP 4.x 기준 문법을 사용했기 때문.
• PHP 5.3을 사용하는 경우 php.ini 파일에서 error_reporting = E_ALL ^ E_DEPRECATED로 설정하면 deprecation 경고의 출력을 막아 정상적으로 ZB4를 사용할 수 있다. 하지만 PHP 5.4부터는 기존 버전에서 deprecated되었던 session_register() 등의 지원이 완전히 삭제되었기 때문에 ZB4를 이용할 수 없다.

5. 관련 문서

• API
• 버전 관리