Files

T

Antigravity Agent e9cbf23ab5 docs(10_Wiki): Dev 폴더 누락분 반영 — Topic_Programming으로 통합

이전 재구성 작업에서 Dev/ 폴더가 누락되었던 것을 반영.

- Dev/Topic_Programming(중첩 폴더, 78개)은 Dev 자체 최상위 폴더들
  (Architecture/Conventions/Engineering_Intelligence 등)과 완전 중복이라 제거.
- Dev 최상위 엔지니어링 지식 폴더(Architecture/Conventions/Engineering_Intelligence/
  Failure_Library/Generalized_Principles/Language/Pattern_Catalog/Platform_Guides/
  Subsystems, 77개)는 이미 Topic_Programming/Topic_Programming에 더 최신 버전이
  존재해 중복 제거(고유 콘텐츠 1개는 예외 처리하여 이동 보존).
- Dev의 W3Schools 언어 튜토리얼 폴더(Topic_C/CPP/CSS/CSharp/HOWTO/HTML/Java/
  JavaScript/PHP/Python/SQL/W3CSS, 1201개)는 전부 Topic_Programming 하위로 이동.
- 에이전트 운영 상태(.astra/docs)는 그대로 유지, 콘텐츠 폴더만 정리.
- Topic_Programming 최종 문서 수: 2784 → 3985.

2026-07-05 00:39:13 +09:00

3.8 KiB

Raw Blame History

id, title, category, status, verification_status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, created_at, updated_at, review_reason, merge_history, tags, raw_sources, applied_in, github_commit

title

Java Annotations

🎯 한 줄 통찰 (One-line insight)

@Override converts a silent bug into a compile error — without it, a typo like makesound() instead of makeSound() just creates an unrelated new method that never overrides anything (program still runs, just wrong), but WITH @Override, the same typo becomes a hard compiler error immediately, since the annotation asserts "this must match a superclass method." [S1]

🧠 핵심 개념 (Core concepts)

Annotation — starts with @; gives extra information to the compiler/tools without changing runtime behavior. [S1]
@Override — asserts a method overrides a superclass method; not required, but catches typo-based bugs at compile time. [S1]
@Deprecated — marks a method/class as outdated; using it still works but triggers an IDE/compiler warning. [S1]
@SuppressWarnings("unchecked") — tells the compiler to ignore a specific warning category (e.g. raw-type usage), useful for legacy code. [S1]

📖 세부 내용 (Details)

@Override catching a typo: class Dog extends Animal { @Override void makesound() { ... } } // error: method does not override or implement a method from a supertype. [S1]
@Deprecated: @Deprecated static void oldMethod() { System.out.println("This method is outdated."); } // triggers deprecation warning when called. [S1]
@SuppressWarnings: @SuppressWarnings("unchecked") public static void main(String[] args) { ArrayList cars = new ArrayList(); cars.add("Volvo"); } — better fixed via ArrayList<String> cars = new ArrayList<>(); instead of suppressing. [S1]

⚖️ 모순 및 업데이트 (Contradictions & updates)

@Override 생략 시 위험: @Override를 제거해도 컴파일러가 경고하지 않으며, 프로그램이 실행은 되지만 의도한 오버라이드가 발생하지 않아 예기치 않게 동작할 수 있음이 명시됨. [S1]

🛠️ 적용 사례 (Applied in summary)

현재 발견된 실제 적용 사례가 없습니다 — raw ArrayList 사용 시 발생하는 unchecked 경고를 억제하기보다 제네릭 타입을 명시해 근본적으로 고치는 방법이 권장된다. [S1]

💻 코드 패턴 (Code patterns)

@Override catching a method-name typo at compile time (Java):

class Animal {
    void makeSound() { System.out.println("Animal sound"); }
}
class Dog extends Animal {
    @Override
    void makesound() { // typo — triggers compile error due to @Override
        System.out.println("Woof!");
    }
}

✅ 검증 상태 및 신뢰도

상태: draft
검증 단계: conceptual
출처 신뢰도: B (W3Schools — widely used educational reference, not a primary standards body)
신뢰 점수: 0.90
중복 검사 결과: 신규 생성 (New discovery)

🔗 지식 그래프 (Knowledge Graph)

상위/루트: Java Tutorial
관련 개념: Java Polymorphism, Java Generics, Java RegEx
참조 맥락: 컴파일러에 추가 정보를 제공하는 도구 — 정규표현식(RegEx) 챕터로 이어짐.

📚 출처 (Sources)

[S1] W3Schools — Java Annotations — https://www.w3schools.com/java/java_annotations.asp

📝 변경 이력 (Change history)

2026-07-04: Initial draft synthesized from the W3Schools "Java Annotations" page (Astra wiki-curation, P-Reinforce v3.1 format).

3.8 KiB Raw Blame History