[java] 확인 및 확인되지 않은 예외를 선택하는시기

여기 내 ‘최종 엄지 손가락 규칙’이 있습니다.
나는 사용한다:

• 호출자로 인한 실패에 대한 내 메소드 코드 내에서 확인되지 않은 예외 ( 명확하고 완전한 문서가 포함됨 )
• 내 코드를 사용하려는 사람에게 명시 적으로 명시 해야하는 수신자 로 인한 실패에 대한 예외 를 확인 했습니다.

이전 답변과 비교할 때, 이것은 하나 또는 다른 (또는 두 가지) 종류의 예외 사용에 대한 명확한 이론적 근거입니다 (하나는 동의하거나 동의하지 않을 수 있음).

두 예외 모두에서, NullPointerException과 같은 매우 일반적인 검사되지 않은 예외를 제외하고 내 응용 프로그램에 대해 자체 검사되지 않은 검사 예외를 생성합니다 ( 여기에서 언급 한 모범 사례 ).

예를 들어 아래의이 특정 기능의 목적은 객체를 만드는 것 (또는 이미 존재하는 경우)을
의미하는 것입니다.

• 만들거나 얻는 객체의 컨테이너가 있어야합니다 (CALLER
  => 검사되지 않은 예외 에 대한 책임 ,이 호출 된 함수에 대한 javadoc 주석 지우기)
• 다른 매개 변수는 널
  ( null) 일 수 없습니다 (코더가이를 호출자에 놓도록 선택하십시오. 코더는 널 매개 변수를 검사하지 않지만 코더는 IT 문서를 처리 함)
• 결과는 NULL이 될 수 없습니다 (수취인
  의 코드에 대한 책임과 선택, 호출자에게 큰 관심을 가질
  선택 => 검사 예외는 모든 호출자가 객체를 만들거나 찾을 수없는 경우 결정을 내려야하기 때문에 반드시 결정해야합니다. 결정은 컴파일시에 적용해야합니다 그들은이와 의미,이 가능성을 처리 할 필요없이이 기능을 사용할 수 없습니다 확인 ) 예외입니다.

예:

/**
 * Build a folder. <br />
 * Folder located under a Parent Folder (either RootFolder or an existing Folder)
 * @param aFolderName name of folder
 * @param aPVob project vob containing folder (MUST NOT BE NULL)
 * @param aParent parent folder containing folder
 *        (MUST NOT BE NULL, MUST BE IN THE SAME PVOB than aPvob)
 * @param aComment comment for folder (MUST NOT BE NULL)
 * @return a new folder or an existing one
 * @throws CCException if any problems occurs during folder creation
 * @throws AssertionFailedException if aParent is not in the same PVob
 * @throws NullPointerException if aPVob or aParent or aComment is null
 */
static public Folder makeOrGetFolder(final String aFoldername, final Folder aParent,
    final IPVob aPVob, final Comment aComment) throws CCException {
    Folder aFolderRes = null;
    if (aPVob.equals(aParent.getPVob() == false) {
       // UNCHECKED EXCEPTION because the caller failed to live up
       // to the documented entry criteria for this function
       Assert.isLegal(false, "parent Folder must be in the same PVob than " + aPVob); }

    final String ctcmd = "mkfolder " + aComment.getCommentOption() +
        " -in " + getPNameFromRepoObject(aParent) + " " + aPVob.getFullName(aFolderName);

    final Status st = getCleartool().executeCmd(ctcmd);

    if (st.status || StringUtils.strictContains(st.message,"already exists.")) {
        aFolderRes = Folder.getFolder(aFolderName, aPVob);
    }
    else {
        // CHECKED EXCEPTION because the callee failed to respect his contract
        throw new CCException.Error("Unable to make/get folder '" + aFolderName + "'");
    }
    return aFolderRes;
}

답변