DOM 객체의 기본 구조도를 알아야한다. 이객체들이 어디에 속해있는지 표를 보고 알아야할것이다

1. 내장함수

(1) 내장메시지 함수

alert("Hello."); confirm("정말로 삭제할껴?"); prompt(메시지, 초기값);

 

(2) 일반내장 함수

isFinite(number) : number가 유한수이면 true, 아니면 false를 리턴

isNaN(value) : value가 순수한 문자이면 true, 숫자형태의 문자이면 false를 리턴

number(obj) : obj를 숫자로 변환하여 리턴

string(obj) : obj를 문자로 변환하여 리턴

eval(수식문자열 또는 Object 문자열) : 수식을 처리한 결과를 리턴, Object로 변환하여 리턴

parseInt(문자열, [진수]) : 문자열을 정수로 변환하여 리턴

parseFloat(문자열) : 문자열을 float-실수형으로 변환하여 리턴

escape(string) : ASCII 스트링을 URL로 인코딩

unescape(string) : ASCII 스트링을 URL로 디코딩

encodeURI(string) : 주어진 문자열을 URI로 encoding 한다.

decodeURI(string) : 주어진 문자열에서 encoding 된 URI를 decoding 한다.

encodeURIComponent(string) : 주어진 문자열을 URI로 encoding 한다.

decodeURIComponent(string) :  주어진 문자열에서 encoding 된 URI를 decoding 한다.

 

(3) 문자인코딩 함수

encodeURI() / decodeURI() : 다음문자만 인초딩한다  è  ; / ? : @ & = + $ , - _ . ! ~ * ' ( ) #

encodeURIComponent() / decodeURIComponent() :

알파벳과 숫자 Alphanumeric Characters 외의, 대부분의 문자를 모두 인코딩한다.

escape() / unescape() : encodeURI() 와 encodeURIComponent() 의 중간 정도의 범위로 문자 인코딩

 

2. 내장 객체

(1) Object 객체

var book = new Object(); // empty Object --> var book = {};

book.title = "내장객체";

book.author = "kspark";

book.published_date = new Array('2006', '2007');

book.getInformation = function() { return this.title + ", " + this.author; }

 

function DisplayPropertyNames(obj){

             var names = "";

             for( var name in obj ) names += name + "\n";

             alert(names);

             alert(obj.getInformation());

}.

 

(2) Function 객체 : 함수 객체, 객체변수 = new Function([매개변수 리스트], 함수의 처리 내용)

var square = function(x) { return x*x }

var sports = new Object();

sports.soccer = new Function('var name = "soccer"; return name;');

var sum = new Function( "x", "y", "return x+y" );

function execute(){

   alert( "Sports name : " + sports.soccer() );

   alert( "sum : " + sum(5,10) );

}

 

(3) Array 배열 객체

length 속성, join(문자열),reverse(),sort(compareFunction),slice(시작위치,종료위치),concat(배열객체)

var list = new Array();

 

(4) Date 날짜 객체

var date = new Date();

 

getDate, getDay, getFullYear, getHours, getMilliseconds, getMinutes, getMonth,

getSeconds, getTime,  getTimezoneOffset, getUTCDate, getUTCDay,

getUTCFullYear, getUTCHours, getUTCMilliseconds, getUTCMinutes,

getUTCMonth, getUTCSeconds, getYear, parse, setDate, setFullYear, setHours,

setMilliseconds, setMinutes, setMonth, setSeconds, setTime, setUTCDate,

setUTCHours, setUTCMilliseconds, setUTCMinutes,  setUTCMonth, setUTCSeconds,

setYear, goGMTString, toLocaleString, toString, toUTCString, UTC, valueOf

 

(5) String 객체

문자열 조작 메소드

toLowerCase(), toUpperCase(), charAt(인덱스), substring(인덱스1, 인덱스2), slice(인덱스1, 인덱스2),

substr(시작인덱스, 길이), indexOf(문자열), lastIndexOf(문자열), concat(문자열), split(분리자, [개수]), charCodeAt([인덱스]), fromCharCode(숫자)

 

글자 모양을 변경하는 메소드

big(), small(), blink(), bold(), fixed(), italics(), strike(가운데줄), sub(아래첨자),sup(위첨자),

fontcolor("색"), fontsize(크기)

 

위치 이동하는 메소드

anchor("책갈피명"), link("이동위치");

 

var str = "Hello! David";

str.slice(6, str.length);   str.link(#david);

 

(6) 수학관련 객체 Math : 각종 수학적 계산을 돕는 Math 객체

Math.PI, Math.sin(x), Math.abs(x), Math.max(x,y)

 

(7) 수치관련 객체 Number

수치 형태의 문자열을 수치 데이터로 변환하는 객체, new Number(수치 형태의 문자열);

var Ten = new Number("10");

 

(8) 논리형 객체 Blooean : 논리 객체, new Boolean(논리값);

 

(9) 스크린 화면 객체 Screen : Screen.availWidth, availHeight(화면의 실제 너비, 높이 ),

Screen.width, height(스크린 실제 너비, 높이), pixelDepth(익스플로워 지원안됨),

colorDepth(사용가능색상수)

 

(10) Event : 이벤트 객체

이벤트 함수의 종류

Abort (onAbort) : 문서를 읽다가 중단시켰을때(브라우저에서 멈춤을 눌렀을때)

Blur (onBlur) : 사용자가 입력을 포커스를 원도우나 입력양식 요소에서 제거했을때

Click (onClick) : 사용자가 입력 양식의 요소나 링크를 클릭 했을때

Change (onChange) : 사용자가 요소의 값을 바꾸었을 때

DblClick (onDblclk) : 사용자가 입력 양식의 요소나 링크를 더블 클릭 했을때

DragDrop (onDragDrop) : 마우스를 드래그 하는 순간 발생

Error (onError) : 문서나 이미지를 읽는 중에 강제로 중지하는 순간 발생

Focus (onFocus) : 사용자가 입력 포커스를 원도우나 입력 양식의 요소로 이동했을 때

KeyDown (onKeyDown) : 사용자가 키를 눌렀을때

KeyPress (onKeyPress) : 사용자가 키를 누르고 있을때

KeyUp( onKeyUp) : 사용자가 눌렀던 키를 놓았을때

Load(onLoad) : 브라우저에서 문서을 읽었을때

MouseDown(onMouseDown) : 마우스를 누르는 순간 발생함

MouseMove(onMouseMove) : 마우스가 움직일 때

MouseOver(onMouseOver) : 사용자가 link나 anchor위로 마우스로 옮겼을때

MouseOut(onMouseOut) : 마우스가 특정 영역 안에 있다가 나갔을때

MouseUp(onMouseUp) : 마우스 커서를 이미지 맵이나 링크 위에서 내려 놓을 때

Move(onMove) : 윈도우나 프레임의 위치가 이동되는 순간 발생

Reset (onReset) : 사용자가 입력 양식을 초기화 했을 때

 

이벤트에서 발생하는 객체들의 종류이며 , 네스케이프와 익스플로어의 경우를 따로 분리했다.

[네스케이프  에서의 이벤트 객체]

data : DragDrop 이벤트로 인해 드롭된 객체의 URL이 들어있는 스트링 배열

height, width : 윈도우나 프레인의 길이와 너비(픽셀표시)

pageX, pageY : 픽셀로 나타낸 커서의 수평/수직 위치(페이지에서의 상대적위치)

screenX, screenY : 픽셀로 나타낸 커서의 수평/수직 위치(화면에서의 상대적 위치)

layerX, layerY : 픽셀로 나타낸 커서의 수평/수직 위치, 이벤트가 발생한 레이어에 대한 상대적 위치.

target : 이벤트가 전송된 원래 객체

type : 발생한 이벤트 유형

which : 눌려진 마우스 버튼(left:1, middle:2, right:3)이나 눌려진 키의 ASCII값

modifiers : 마우스나 키 이벤트와 연관된 수정자 키

(ALT_MASK,CONTROL_MASK,SHIFT_MASK,META_MASK) 를 식별

 

[익스플로어 에서의 이벤트 객체]

screenX, screenY : 픽셀로 나타낸 커서의 수평/수직 위치(화면에서의 상대적 위치)

clientX, clientY : 픽셀로 나타낸 커서의 수평/수직 위치, 이벤트가 발생한 웹페이지에서의 상대적 위치

offsetX, offsetY : 픽셀로 나타낸 커서의 수평/수직 위치,이벤트가 발생한 컨테이너에 대한 상대적 위치

X, Y : 픽셀로 나타낸 커서의 수평/수직 위치, 이벤트가 발생한 문서에 대한 상대적 위치

srcElement : 이벤트가 전송된 원래 객체

type : 발생한 이벤트 유형

keyCode : 키 누름과 연관된 Unicode 키 코드를 식별

button : 이벤트가 발생했을 때 눌려진 마우스 버튼 식별(0:눌려진버튼없음, 1:왼, 2:오, 4:가)

altkey,ctrlkey,shiftkey : true나 false로 설정하여 이벤트가 발생했을 때 Alt키와 Control키, Shift 키 중에 어떤 것이 눌려졌는지 알려준다.

cancelBubble : true나 false로 설정하여 이벤트 버블링을 취소하거나 활성화한다.

fromElement, toElement : 이동 중인 HTML 요소 지정

reason : 데이터 소스 객체에 대한 데이터 전송 상태를 나타내는데 사용

returnValue : true나 false로 설정하여 이벤트 핸들러의 리턴값을 나타낸다. 이벤트 핸들러에서 true나 false를 리턴하는 것과 같다.

 

위에서 열거한 이런 내용을 암기는 하지 못하더라도 모두 이해하고 어떤경우에 쓰이는지를

파악하고 있어야하겠다. 자바스크립트를 사용하는 사람들의 가장 기본적으로 갖추어야 하는 지식이다.



출처 : http://mainia.tistory.com/entry/Javascript-에서-알아야할-기초사항

프로젝트에 나가 주로 쓰이는 자바스크립트 함수를 모아 놓은것이다. 필요하다 싶으면 이 페이지에
업데이트하여 필요할때 복사해 쓸 작정이다.

 

/**

 * 입력값이  null 인지 체크한다

 */

function isNull(input){

       if (input.value == null || input.value == ""){

             return true;

       }else{

             return false;

       }

}

/**

 * 입력값이 스페이스 이외의 의미있는 값이 있는지 체크한다

 * if (isEmpty(form.keyword)){

 *       alert('값을 입력하여주세요');

 * }

 */

function isEmpty(input){

       if (input.value == null || input.value.replace(/ /gi,"") == ""){

             return true;

       }else{

             return false;

       }

}

/**

 * 입력값에 특정 문자가 있는지 체크하는 로직이며

 * 특정문자를 허용하고 싶지 않을때 사용할수도 있다

 * if (containsChars(form.name, "!,*&^%$#@~;")){

 *       alert("특수문자를 사용할수 없습니다");

 * }

 */

function containsChars(input, chars){

       for (var i=0; i < input.value.length; i++){

             if (chars.indexOf(input.value.charAt(i)) != -1){

                    return true;

             }

       }

       return false;

}

/**

 * 입력값이 특정 문자만으로 되어있는지 체크하며

 * 특정문자만을 허용하려 할때 사용한다.

 * if (containsChars(form.name, "ABO")){

 *    alert("혈액형 필드에는 A,B,O 문자만 사용할수 있습니다.");

 * }

 */

function containsCharsOnly(input, chars){

       for (var i=0; i < input.value.length; i++){

             if (chars.indexOf(input.value.charAt(i)) == -1){

                    return false;

             }

       }

       return true;

}

/**

 * 입력값이 알파벳인지 체크

 * 아래 isAlphabet() 부터 isNumComma()까지의 메소드가 자주 쓰이는 경우에는

 * var chars 변수를 global 변수로 선언하고 사용하도록 한다.

 * var uppercase = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";

 * var lowercase = "abcdefghijklmnopqrstuvwxyz";

 * var number = "0123456789";

 * function isAlphaNum(input){

 *       var chars = uppercase + lowercase + number;

 *    return containsCharsOnly(input, chars);

 * }

 */

function isAlphabet(input){

       var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";

       return containsCharsOnly(input, chars);

}

/**

 * 입력값이 알파벳 대문자인지 체크한다

 */

 function isUpperCase(input){

       var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ";

       return containsCharsOnly(input, chars);

 }

/**

 * 입력값이 알파벳 소문자인지 체크한다

 */

function isLowerCase(input){

       var chars = "abcdefghijklmnopqrstuvwxyz";

       return containsCharsOnly(input, chars);

}

/**

 * 입력값이 숫자만 있는지 체크한다.

 */

function isNumer(input){

       var chars = "0123456789";

       return containsCharsOnly(input, chars);

}

/**

 * 입려값이 알파벳, 숫자로 되어있는지 체크한다

 */

function isAlphaNum(input){

       var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";

       return containsCharsOnly(input, chars);

}

/**

 * 입력값이 숫자, 대시"-" 로 되어있는지 체크한다

 * 전화번호나 우편번호, 계좌번호에 -  체크할때 유용하다

 */

function isNumDash(input){

       var chars = "-0123456789";

       return containsCharsOnly(input, chars);

}

/**

 * 입력값이 숫자, 콤마',' 로 되어있는지 체크한다

 */

function isNumComma(input){

       var chars = ",0123456789";

       return containsCharsOnly(input, chars);

}

/**

 * 입력값이 사용자가 정의한 포맷 형식인지 체크

 * 자세한 format 형식은 자바스크립트의 'reqular expression' 참고한다

 */

function isValidFormat(input, format){

       if (input.value.search(format) != -1){

             return true; // 올바른 포멧형식

       }     

       return false;

}

/**

 * 입력값이 이메일 형식인지 체크한다

 * if (!isValidEmail(form.email)){

 *       alert("올바른 이메일 주소가 아닙니다");

 * }

 */

function isValidEmail(input){

       var format = /^((\w|[\-\.])+)@((\w|[\-\.])+)\.([A-Za-z]+)$/;

       return isValidFormat(input, format);

}

/**

 * 입력값이 전화번호 형식(숫자-숫자-숫자)인지 체크한다

 */

function isValidPhone(input){

       var format = /^(\d+)-(\d+)-(\d+)$/;

       return isValidFormat(input, format);

}

/**

 * 입력값의 바이트 길이를 리턴한다.

 * if (getByteLength(form.title) > 100){

 *    alert("제목은 한글 50자 (영문 100자) 이상 입력할수 없습니다");

 * }

 */

function getByteLength(input){

       var byteLength = 0;

       for (var inx = 0; inx < input.value.charAt(inx); inx++)     {

             var oneChar = escape(input.value.charAt(inx));

             if (oneChar.length == 1){

                    byteLength++;

             }else if (oneChar.indexOf("%u") != -1){

                    byteLength += 2;

             }else if (oneChar.indexOf("%") != -1){

                    byteLength += oneChar.length / 3;

             }

       }

       return byteLength;

}

/**

 * 입력값에서 콤마를 없앤다

 */

function removeComma(input){

       return input.value.replace(/,/gi,"");

}

/**

 * 선택된 라디오버튼이 있는지 체크한다

 */

function hasCheckedRadio(input){

       if (input.length > 1){

             for (var inx = 0; inx < input.length; inx++){

                    if (input[inx].checked) return true;

             }

       }else{

             if (input.checked) return true;

       }

       return false;

}

/**

 * 선택된 체크박스가 있는지 체크

 */

function hasCheckedBox(input){

       return hasCheckedRadio(input);

}

Log4sql 설치와 쿼리의 실제 내용을 log로 볼수 있는 방법
ORM 이나 Spring JDBC 등을 통해서 쿼리를 날리게 되면 로그로 쿼리의 조합된 모양을 보기가
상당히 힘들다. 그리고 log4sql 를 중간에 설치해 쿼리의 내용을 로그로 찍어줄수가 있다.

사이트 : http://log4sql.sourceforge.net
한국 국기를 클릭하면 한글 사이트로 번역이 된다.
 

다운받은 파일을 열게 되면 log4sql.jar, log4sql_conf.jsp있다.
log4sql.jar 라이브러리 폴더에 넣으면 되고 , jsp 페이지는 설정값을 변경할수 있는 방법을 제공한다.

다음은 프로젝트 파일에서 설정값을 변경한다.
Jdbc driverClassName 설정값을 변경해야되는데 그 값은 value 값을
core.log.jdbc.driver.OracleDriver 설정하면된다. Log4jsql.jar열어보면 여러종류의 드라이버가
있으니 그에 맞는 클래스를 선택하면된다.

Jdbc connect 정보를 설정한 곳에 보통 xml 파일에 설정이 되어있는데
<property name="driverClassName" value="core.log.jdbc.driver.MssqlDriver"/>
<property name="url" value="jdbc:microsoft:sqlserver://xxx.xxx.xxx.xxx:1433;DatabaseName=spring"/>
<property name="username" value="xxxxx"/>
<property name="password" value="xxxxx"/>

아래그림과 같이 elapsed time 처럼 쿼리가 걸리는 시간도 찍히게 된다

출처 : http://sinuk.egloos.com/2676307

1. JNI (Java Native Interface) 란 ?

- 자바가 다른 언어로 만들어진 어플리케이션과 상호 작용할 수 있는 인터페이스를 제공한다.

- 자바가상머신(JVM)이 원시 메소드(native method)를 적재(locate)하고 수행(invoke)할 수 있도록 한다

- JNI가 자바가상머신내에 포함됨으로써, 자바가상머신이 호스트 운영체제상의 입출력, 그래픽스, 네트워킹, 그리고 스레드와 같은 기능들을 작동하기 위한 로컬시스템호출(local system calls)을 수행할 수 있도록 한다.

* 쉽게 말해 Java와 다른 언어를 연동하는 솔루션입니다.

[그림1] C로 만들어진 Library와 JAVA를 연결해주는 JNI

2. Why do you need JNI ?

자 바 네이티브 메쏘드(Java Native method, 이하 JNI)는 다른 언어로 작성된 코드를 자바에서 호출하도록 만들어진 규약이다. 현재는 C/C++에 대한 호출만을 정확하게 지원한다. 어떻게 보면 JNI는 자바가 만들어진 철학과 정반대되는 것이다.

그러나. Java에도 한계가 있다.

1. 속도 문제가 있는 계산 루틴
 > 자바가 Native Code(플랫폼에 종속적인 기계어 코드)에 비해 느리다.

2. 자바에서 하드웨어 제어

3. 자바에서 지원되지 않은 특정 운영체제 서비스
 > 자바의 클래스 라이브러리는 방대하고 다양한 서비스를 제공하지만, 특정 플랫폼에서 제공하는 고유의 서비스의 기능을 모두 포함할 수는 없다. 특히, 특수한 목적으로 제작된 하드웨어를 자바에서 제어해야 할 필요가 있다고 한다면, 자바만으로 해결하기는 힘들다.

4. 기존의 프로그램에서 자바가 제공하는 서비스를 이용
 > 기존에 작성된 프로그램이나 기존의 시스템(legacy)과의 연계 문제

∴ JNI를 써서 해결해보자.

3. C를 이용한 JNI 예제

VC++을 이용해 C문법으로 작성되어 만들어진 DLL을 로딩하여 Java에서 사용해보겠습니다.

1단계 : Native Method를 선언하는 자바 클래스 작성
2단계 : 1단계에서 작성한 클래스 컴파일
3단계 : javah를 사용해서 Native Method가 사용할 헤더 파일 생성
4단계 : C언어로 Native Method 실제 구현
5단계 : C 코드와 헤더 파일을 컴파일
6단계 : 자바 프로그램 실행

 

1단계 : Native Method를 선언하는 자바 클래스 작성

Java 소스 파일 : HelloJni_Jsource.java

import java.util.*;

class HelloJniClass {
   native void Hello();

  static {  System.loadLibrary("Hello_DLL");   }

  public static void main(String args[]) {   
      HelloJniClass myJNI=new HelloJniClass();
      myJNI.Hello();
   }
}

// 아래는 좀 위의 내용 보충 그림

2단계 : 1단계에서 작성한 클래스 컴파일

* 컴파일시에는 일반 java 컴파일때와 마찬가지로 환경변수 셋팅이 되어 있어야 합니다.
 -> Path가 JDK의 Javac.exe가 있는 폴더에 설정되어 있어야 합니다.

3단계 : javah를 사용해서 Native Method가 사용할 헤더 파일 생성

HelloJniClass.h을 열어보면

JNIEXPORT void JNICALL Java_HelloJniClass_Hello  (JNIEnv *, jobject);
위의 함수를 Implement만 해서 DLL을 만들면 됩니다. (4단계)

4단계 : C언어로 Native Method 실제 구현(1)

1) VC++ 프로젝트 만들기 : Win32용 DLL 프로젝트로 만듭니다.
New - Projects : Win32 Dynamic-Link Library

2) Add Files Projects : HelloJniClass.h 파일 추가

3) Projects Setings(Alt+F7)
   - Link탭에 Output file Name : 1단계의 2. 라이브러리 적재시 작성한 DLL파일명(Hello_DLL.dll)
   - C/C++탭 Preprocessor 카테고리의 Additional Include directories
       JDK의 Include폴더와 Include폴더 밑의 win32폴더

          예) C:\Program Files\Java\jdk1.5.0_03\include\,
             C:\Program Files\Java\jdk1.5.0_03\include\win32

 

4. 값의 전달과 리턴

 

1단계 : Java 소스 파일 StringPass_Jsource.java
* 일반 자바 메쏘드 선언과 동일합니다.

class JNI_Message {
   native byte[] Message(String input);

  // 라이브러리 적재(Load the library) 

  static {
    System.loadLibrary("Msg_DLL");
  }

  public static void main(String args[]) {   
 byte buf[];

    // 클래스 인스턴스 생성(Create class instance)
    JNI_Message myJNI=new JNI_Message();

    // 원시 메소드에 값을 주고 받음
    buf = myJNI.Message("Apple");
 
 System.out.print(buf); // 받은값 출력
 }
}

2단계 : 컴파일
 javac StringPass_Jsource.java

3단계 : header파일 생성
 javah JNI_Message

4단계 : method구현 : StringJNIDLLSource.c

#include <stdio.h>
#include <jni.h>
#include <string.h>
#include "JNI_Message.h"

JNIEXPORT jbyteArray JNICALL Java_JNI_1Message_Message (JNIEnv * env, jobject jobj, jstring input)
{
    jbyteArray jb;
    jboolean iscopy;
    char* buf;
    static char outputbuf[20];

    buf=(*env)->GetStringUTFChars(env, input, &iscopy);  // 입력 String 읽어오는 함수
    printf ("\nDLL receive Data from JAVA : %s\n",buf);   // 입력받은 내용을 출력
    strcpy(outputbuf,"Delicious !!\n");
    jb=(*env)->NewStringUTF(env, outputbuf);  // 출력할 내용의 java버퍼에 output버퍼값을 셋팅

   return(jb); // java버퍼 리턴
}

(*env)->함수명 형태로, JAVA의 메쏘드를 C에서 이용할수 있습니다.
* JAVA는 C로 문자열을 넘겨줄때 UTF-8형태를 사용합니다.

5단계 : 실행

C:\test\C_JNI\Paramerter Pass>java JNI_Message

DLL receive Data from JAVA : Apple
Delicious !!

5. KVM ? KNI ?

KVM은 J2ME의 일부로서 작고 자원이 한정된 기계장치를 위해 설계된 소형 JVM.
JVM에서는 JNI가 KVM의 KNI가 있다.

 

6. 기타프로그래밍 이슈들
참고 URL :http://www.javastudy.co.kr/docs/jhan/javaadvance/jni.html

언어적 이슈(Language Issues)
메소드 호출(Calling Methods)
필드의 참조(Accessing Fields)
스레드와 동기화(Threads and Synchronization)
메모리 이슈(Memory Issues)
수행(Invocation)
스레드 연결(Attaching Threads)

우리는 코딩을 하면서 String을 비교할 때 무의식적으로 아래와 같이 코딩을 합니다.
aString.equals(bString)

 하지만 왜 String을 비교할 때만 이렇게 비교하는지 우리는 알고 코딩을 하고 있는 것일까? int, boolean, long 등은 == 로 비교를 하면서 String은 왜 다를까?

 지금부터  String을 비교할 때 .equals()와 == 이 어떻게 다른지 알아보자.

 일단 코드를 실행해보고 결과를 보면서 진행하겠습니다. 저는 백문이불여일견이라는 말을 좋아하거든요.^^
public class Test {     /**      * @param args      */     public static void main(String[] args) {         // TODO Auto-generated method stub         new Test().testString();     }     public void testString() {         String a = "TEST";         String b = "TEST";         String c = new String("TEST");         String d = new String("TEST");         System.out.println("1:"+System.identityHashCode(a));         System.out.println("2:"+System.identityHashCode(b));         System.out.println("3:"+System.identityHashCode(c));         System.out.println("4:"+System.identityHashCode(d));         System.out.println("5:"+(a == b));         System.out.println("6:"+a.equals(b));         System.out.println("7:"+(c == d));         System.out.println("8:"+c.equals(d));     } }

위 코드를 실행해 보면 결과는 다음과 같이 나옵니다.


결과를 보면 a,b는 hashcode값이 같지만 c,d는 값이 다른 것이 보입니다.
그럼 이번엔 비교한 결과를 볼까요? a,b는 equals()로 비교를 하거나 ==로 비교를 해도 결과는 항상 true 입니다. 하지만 c,d는 equals() 비교를 하면 트루지만 ==로 비교를 하면 false죠.

왜 이런 결과가 나올까요?

 이런 결과가 나오는 이유는 equals()는 비교대상의 문자열 리터럴(값)을 비교하고 ==는 대상 객체를 비교하기 때문입니다. 또한 자바에서는 a,b처럼 같은 값을 가지면 하나의 메모리 주소를 참조하게 됩니다. 즉, a,b의 "TEST"라는 문자열 리터럴은 컴파일되면 String 객체가 되는데 a,b는 같은 메모리 주소를 가지게 됩니다. 하지만 c,d는 처음부터 별도의 String 객체로 생성되었기 때문에 동일한 "TEST"라는 문자열 리터럴을 가지지만 서로 다른 객체가 됩니다.
 무슨말인지 모르시겠다구요? 그럼 그림으로 한번 볼까요?
간단하게 정리하자면 a,b는 문자열 리터럴이 컴파일시에 자동으로 하나의 String 객체가 되고 b,c는 별도의 객체가되어서 문자열 리터럴(값)으로 비교를 하면 a,b,c,d 모두 같지만 객체로 비교를 하게 되면 (a,b),c,d의 3개의 객체가 되는 것입니다.

 여기서 이어지는 또다른 의문점... 프리미티브 타입과 Wrapper 클래스의 비교는 어떻게 될까요?
아래 코드를 한번 돌려 보세요. 8번까지는 위 내용과 비슷하지만 9번 결과는 어떻게 나올까요?
 다음에는 프리미티브 타입과 Wrapper 클래스, 자동 Boxing, 자동 UnBoxing에 대해서 알아 보도록 하겠습니다.

package net.westzero; public class Test {     /**      * @param args      */     public static void main(String[] args) {         // TODO Auto-generated method stub         new Test().testInteger();     }       public void testInteger() {         int a = 1;         int b = 1;         Integer c = new Integer(1);         Integer d = new Integer(1);         System.out.println("1:"+System.identityHashCode(a));         System.out.println("2:"+System.identityHashCode(b));         System.out.println("3:"+System.identityHashCode(c));         System.out.println("4:"+System.identityHashCode(d));         System.out.println("5:"+(a == b)); //        System.out.println("6:"+a.equals(b));         System.out.println("7:"+(c == d));         System.out.println("8:"+c.equals(d));         System.out.println("9:"+(a == c));     } }



출처 : http://westzero.net/21?category=6

log4sql은 많이 알려지진 않았지만 상당히 유용한 sql 로거입니다. 만든 분은 송인섭이라는분인데 한국분이신것 같습니다.

 기존에 우리는 sql을 디버깅 하기 위해서 대부분 System.out.println()을 사용했습니다. log4j를 이용해서 sql을 콘솔에 찍기도 하고 jdbc관련 클래스를 만들어서 사용하는 경우에도 결국엔 System.out.println()을 사용하게 됩니다. 하지만 sql을 이렇게 콘솔로 표현하게 되면 여러가지 불편한 점들이 생깁니다.
 가장 큰 문제점이 바로 소스는 소스대로, 콘솔은 콘솔대로 가독성이 떨어지게 됩니다. 소스상에서 System.out을 사용하게되면 개발이 끝나도 운영에 들어가게되면 이 부분을 주석처리하거나 다른 설정을 하게됩니다.
 또한 콘솔에서 보여질때 sql을 소스상에서 들여쓰기를 해주지 않았다면 단순한 sql은 괜찮지만 복잡한 sql은 볼때마다 매번 들여쓰기를 해주어야 한다는 단점이 있습니다. log4sql은 이러한 문제를 해결하기 위해서 간단히 드라이버 설정만 바꿔주면 System.out.println()을 사용하지 않아도, 소스상에서 들여쓰기를 해주지 않아도 콘솔에 예쁘게 들여쓰기가 된 sql을 보여줍니다.

log4sql이 뭔가요?

간단하게 log4sql이 무엇인지 백번 설명을 하기보다는 한번 보는게 확실히 이해하기 쉬울꺼 같습니다.
저 노란색 박스안에 나타난 내용이 log4sql에서 자동으로 찍어준 내용입니다. sql이 실행된 시간과 실행된 메소드, sql이 실행되는데 소요된 시간, 실행된 sql을 자동으로 들여쓰기를 해서 보여주고 있습니다.

log4sql의 장점

1. 자동 들여쓰기

일반적으로 콘솔에 들여쓰기가 된 sql을 보려면 다음과 같은 코드를 작성해야 했습니다.
StringBuffer  var11 = new StringBuffer(); var11.append("SELECT * \n"); var11.append(" FROM   emp \n"); var11.append(" WHERE  deptno = '30' \n");
하지만 더이상 이런 부분은 신경 쓰지않아도 됩니다. log4sql을 사용한다면 말이죠.

2. 페이지 반응속도가 느리다구요?

log4sql은 쿼리가 실행되는데 걸린 시간을 표시해줍니다. 어느 부분이 느린지 어느 쿼리가 느린지 콘솔을 보기만 하면 알 수 있습니다.

3. 이 쿼리가 어디서 날린 쿼리지?

log4sql은 쿼리가 실행된 메소드도 표시해 줍니다. 하지만 쿼리를 날리는 클래스를 별도로 두고 해당 클래스를 이용해서 쿼리를 날리게 되면 log4sql도 어쩔수 없답니다.^^;;

어떻게 사용하나요?

간단합니다. JDBC 관련 설정에서 드라이버 설정만 바꿔주면 됩니다. 예를 들어 오라클을 사용하는 경우 기존에 'oracle.jdbc.drirver.OracleDriver' 드라이버를 사용했다면 'core.log.jdbc.driver.OracleDriver'로 바꿔주기만 하면 됩니다. 이제 log4sql을 사용할 준비가 된겁니다. 이제 WAS를 올리고 콘솔을 한번 보세요. sql이 깔끔하게 정리되어서 나타날꺼에요.^^
다른 디비를 사용하시는 경우에는 log4sql 홈페이지에서 확인하시면 됩니다.

다음에는 log4sql의 상세 설정에 대해서도 알아보도록 하겠습니다.



출처 : http://westzero.net/16

Oracle9i Dataguard 구성 방법
2006년 1월 22일
민연홍(Oracle OCM), DBA LG카드 중형서버운영파트


미국의 911테러 이후 전세계 IT시스템의 화두는, 자연재해 또는 테러로 인해 서비스 손실을 입게 될 경우에도 이를 복구할 수 있는 Standby 시스템을 구축하는 것이 되었다. 서버뿐만 아니라 디스크 및 백업장비까지 손실되었을 경우에도 다른 지역에서 서비스를 기동할 수 있는 시스템 구성이 각광받게 된 것이다. 이러한 Standby시스템에서 오라클의 dataguard는 데이터 무손실을 구현할 수 있는 방법으로, 한국에서는 여러 금융기관에서도 사용하고 있다. 여기서는 dataguard에 대한 간단한 소개와 그 구성방법에 대해서 알아본다.

Part 1. dataguard 개요 및 아키텍처
  1) dataguard 란 무엇인가?
  2) switchover and failover
  3) standby DB의 종류
  4) dataguard의 서비스 종류
  5) protection mode
  6) dataguard의 시스템 구성(2가지 종류)

Part 2. standby DB 기동방법

Part 3. 시스템 구축 (실습)
  1) 리스너 설정 및 기동
  2) tnsnames.ora 설정
  3) 오라클 초기화 파라미터 설정
  4) primary DB를 online backup으로 standby DB 위치로 restore
  5) primary DB에서 standby control file을 생성해서 standby DB로 전송
  6) standby DB에서 사용할 control file을 배치
  7) standby DB 기동
  8) standby DB에 standby redo log file 생성
  9) primary DB에 standby redo log file 생성
  10) standby DB를 recovery managed mode로 기동
  11) log switch 적용
  12) primary DB 점검
  13) standby DB 점검
  14) primary DB 테이블스페이스 생성 및 데이터 입력
  15) standby DB예 데이터 입력 여부 확인
  16) takeover 하기
  17) 서비스 원복(takeover)
  18) failover 하기

PartⅠ. dataguard 개요 및 아키텍처

 1) dataguard 란 무엇인가?

   - primary DB와 standby DB를 동기화시켜, primary DB가 하드웨어 장애 등의 문제가 생겼을 경우 standby DB로 failover 또는
     switchover 시킬 수 있는 시스템 구성을 말한다.
   - Oracle Net을 통해서 primary DB의 변경정보를 standby DB로 적용시켜 운영된다.

      

 2) switchover and failover

   ① 자동실행이 아니라 DBA가 action을 취해야 한다.

   ② switchover
     - OS 작업 또는 서버 PM작업 시 사용(primary -> standby , standby -> primary)

   ③ failover
     - 디스크 fail 등 긴급상황에서 사용, dataguard 재구성 필요

 3) standby DB의 종류

   ① Physical standby database
     - block 대 block 기반으로 primary DB의 redo log를 적용시켜 standby DB를 동기화

   ② Logical standby database
     - 같은 schema 정의로 공유
     - primary DB의 sql 문장을 standby DB에 적용

 4) dataguard의 서비스 종류

   ① Log transport Services
     - primary DB에서 standby DB로 redo log 정보를 자동으로 전송

   ② Log Apply Services
     - redo log를 standby DB에 적용

   ③ Role Management Service
     - 데이터베이스는 primary/standby로 두 가지의 상대적으로 배타적인 role을 가진다.
       Role Management Service는 log transport service와 log apply service를 failover 또는 switchover의 상황에 동적으로
       변경할 수 있다.

 5) protection mode

   ① Maximum Protection - primary    DB와 standby DB의 redo log를 동기화 시킨다.
      standby DB가 네트워크 이상 등의 이유로 standby로의 전송이 안될 경우 primary DB를 halt시킨다.
      데이터는 서로 동기화되어 primary DB에서 commit을 하게 되면 standby DB에서 commit이 완료될 때까지 primary DB에서 commit 완료를 하지 않는다.
      성능에는 문제를 줄 소지가 있으나 failover 상황이 오더라도 데이터 손실은 없다. physical standby DB에만 가능하다.

   ② Maximum availability - Maximum Protection과 마찬가지로 primary DB와 standby DB를 동기화시킨다.
      단, standby DB가 네트워크 문제 등의 이유로 전송이 안될지라도 halt되지는 않는다.
      데이터는 maximum protection과 마찬가지로 primary DB에서 commit을 하게 되면 standby DB에서 commit이 완료될 때까지
      primary DB에서 commit 완료를 하지 않는다. 만약 standby DB가 unavailable상태일 경우 임시로 불일치 시킨다.
      또 다시 standby DB가 available하면 자동으로 동기화 시킨다. 성능에는 문제를 줄 소지가 있으나 failover 상황이 오더라도
      데이터 손실은 거의없다. physical standby, logical standby DB 모두 가능하다.

   ③ Maximum Performance - default protection mode이다. primary data에 대한 protection이 가장 낮다.
      primary database에 transaction이 수행되면 이것을 asynchronous 하게 standby DB에 적용한다.
      즉, maximum protection, maximum availability의 경우에는 standby DB에 적용(commit) 될 때까지 primary db의 transaction 이 적용(commit)되지 않았으나,
      Maximum Performance 모드에서는 비 동기화 시키므로 primary DB에서 standby DB가 transaction 적용이 끝날 때까지
      기다리지 않는다. 즉 standby db의 문제로 인해서 primary DB에 성능영향이 가지 않는다.
      단, failover시에는 약간의 데이터 손실을 가져올 수 있다.

 6) dataguard의 시스템 구성(2가지 종류)

  ① physical standby database 구성 (LGWR process를 사용한 Physical standby DB)
      Archiving to a Physical standby Destination Using the Logwriter Proces


      


     - primary db의 LGWR 프로세스가 standby DB로 redo log를 보내고, standby DB의 RFS 프로세스가 redo log를 standby redo
      log에 적용시킨다. archiving되면 archived redo logs가 되고 이것을 MRP process가 standby DB에 적용시킨다.

   ② logical standby DB 구성
     Archiving to a Logical standby Destination Using the Logwriter Process

      

     - logical standby DB는 primary DB에서 수행된 SQL문장을 LGWR프로세스가 standby DB로 보내고 RFS 프로세스가 받아서
      Archived redo logs에 쓴다. LSP (Logical standby process)가 standby DB에 적용시킨다.

     - primary DB에서 log switch가 일어나게 되면 standby DB의 RFS 프로세스에 이를 알려주어 log switch가 되도록 한다.

TOP

PartⅡ. standby DB 기동방법

  - 주의 standby db의 startup 방식을 보면 아래와 같다. 아래 그림을 기억해두면 편하다.
    

   ① standby DB를 read only mode에서 managed recovery mode로 변경
     - 그대로 명령 또는 shutdown immediate 이후 재기동

     - 첫번째 방법

      SQL> alter database open read only;
      SQL> recover managed standby database disconnect; 

     - 두번째 방법

      SQL> shutdown immediate 
      SQL> startup nomount
      SQL> alter database mount standby database;
      SQL> recover managed standby database disconnect;

   ② shutdown 에서 managed recovery mode 로 변경

      SQL> startup nomount
      SQL> alter database mount standby database;
      SQL> recover managed standby database disconnect;

   ③ managed recovery mode 에서 read only mode 로 변경

      SQL> recover managed standby database cancel;
      SQL> alter database open read only;

   ④ read only standby DB 에서 managed recovery mode로 변경
      (먼저 standby DB에 연결된 모든 세션을 종료)

      SQL> recover managed standby database disconnect;

     - 만약 유저의 세션 때문에 실패할 경우

      SQL> shutdown immediate
      SQL> startup nomount
      SQL> alter database mount standby database;
      SQL> recover managed standby database disconnect;

TOP

PartⅢ. 시스템 구축 (실습)

  - 실습에서 사용 할 primary DB 이름은 MIN 이고, standby DB 이름은 STBY 이다.
  - 여기서는 하나의 서버에서 2개 DB를 구성하는 방법으로 수행한다.
  - 서로 다른 두 대의 서버에서도 같은 방법으로 구성 할 수 있다.
  - primary DB는 /data1/oradata/MIN에 구성되어 있다.
  - standby DB는 /data1/oradata/STBY에 구성되어 있다.

 1) 리스너 설정 및 기동

  아래와 같은 네트워크 설정을 해준다. 각 서버마다 설정해준다.
    - MIN DB에서 설정(primary DB)

vi $ORACLE_HOME/network/admin/listener.ora smsvr1_MIN =    (ADDRESS_LIST =          (ADDRESS= (PROTOCOL= TCP)(Host= smsvr1)(Port=2001))    ) SID_LIST_smsvr1_MIN =  (SID_LIST =    (SID_DESC =      (ORACLE_HOME= /u/pkg/oracle/product/9.2.0)      (SID_NAME = MIN)    )  )

  -STBY DB 에서 설정(physical standby DB)

vi $ORACLE_HOME/network/admin/listener.ora smsvr1_STBY =    (ADDRESS_LIST =          (ADDRESS= (PROTOCOL= TCP)(Host= smsvr1)(Port=2002))    ) SID_LIST_smsvr1_STBY =    (SID_LIST =     (SID_DESC =      (ORACLE_HOME= /u/pkg/oracle/product/9.2.0)     (SID_NAME= STBY)    )   )

 2) tnsnames.ora 설정

  tnsnames.ora 파일을 설정한다. 서로 네트워크가 가능하도록 하는데 이름을 재대로 써야 한다.
  초기화 파라미터에서 log_archvie_dest_2='service=STBY LGWR SYNC AFFIRM' 일 경우
  STBY는 tnsnames.ora 에서의 접속이름을 말한다.

- MIN DB 설정 primary DB에서 설정 ( standby DB로 가는 네트워크 구성)

vi $ORACLE_HOME/network/admin/tnsnames.ora STBY =   (DESCRIPTION =      (ADDRESS = (PROTOCOL= TCP)(Host= smsvr1)(Port= 2002))      (CONNECT_DATA = (SID = STBY))   )

- STBY DB 설정, standby DB에서 설정 (primary DB로 가는 네트워크 구성)

vi $ORACLE_HOME/network/admin/tnsnames.ora MIN=   (DESCRIPTION =      (ADDRESS = (PROTOCOL= TCP)(Host= smsvr1)(Port= 2001))      (CONNECT_DATA = (SID = MIN))   )

 3) 오라클 초기화 파라미터 설정

- MIN DB (primary DB)

vi $ORACLE_HOME/dbs/initMIN.ora db_name=MIN compatible=9.2.0 control_files=('/data1/oradata/MIN/control01.ctl','/data1/oradata/MIN/control02.ctl') shared_pool_size=64M db_cache_size=16M undo_management=auto background_dump_dest=/data1/oradata/MIN/bdump user_dump_dest=/data1/oradata/MIN/udump core_dump_dest=/data1/oradata/MIN/cdump log_archive_start=true log_archive_dest_1="location=/data1/oradata/MIN/archive1" log_archive_format=%t_%s.arc #### 데이터가드를 위해서 변경하지 말 것 remote_archive_enable=true dg_broker_start=true log_archive_dest_state_1=enable log_archive_max_processes=3 standby_file_management=auto db_file_name_convert='/data1/oradata/STBY','/data1/oradata/MIN' log_file_name_convert='/data1/oradata/STBY','/data1/oradata/MIN' standby_archive_dest='/data1/oradata/MIN/archive2' ##### standby DB이면 열고, primary DB이면 닫는다. #fal_server=STBY #fal_client=MIN #lock_name_space=STBY ## primary DB이면 열고, standby DB이면 닫는다. log_archive_dest_2='SERVICE=STBY LGWR SYNC'

- STBY DB (standby DB) -주의할 것은 DB이름은 MIN 이며 instance 이름과 SID는 STBY 이다.
즉, 기동을 할 때에도 ORACLE_SID=STBY 로 설정하여 기동한다.

vi $ORACLE_HOME/dbs/initSTBY.ora db_name=MIN compatible=9.2.0 control_files=('/data1/oradata/STBY/control01.ctl','/data1/oradata/STBY/control02.ctl') shared_pool_size=64M db_cache_size=16M undo_management=auto background_dump_dest=/data1/oradata/STBY/bdump user_dump_dest=/data1/oradata/STBY/udump core_dump_dest=/data1/oradata/STBY/cdump log_archive_start=true log_archive_dest_1="location=/data1/oradata/STBY/archive1" log_archive_format=%t_%s.arc ### 데이터가드를 위해서 변경하지 말 것 remote_archive_enable=true dg_broker_start=true log_archive_dest_state_1=enable log_archive_max_processes=3 standby_file_management=auto db_file_name_convert='/data1/oradata/MIN','/data1/oradata/STBY' log_file_name_convert='/data1/oradata/MIN','/data1/oradata/STBY' standby_archive_dest='/data1/oradata/STBY/archive2' ## standby DB일 경우 아래를 열기, primary DB일 경우 닫기 fal_server=MIN fal_client=STBY lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. #log_archive_dest_2='SERVICE=MIN LGWR SYNC'

-초기화 파라미터 설정에서 주의해야 할 것을 먼저 보면,
standby_file_management=auto 로 되어 있어야 primary DB에서 물리적인 테이블스페이스 및 데이터파일 추가할 경우 standby DB에 자동으로 생성된다.

standby_file_management=auto로 되어 있을 경우
db_file_name_convert='/data1/oradata/STBY','/data1/oradata/MIN'

log_file_name_convert='/data1/oradata/STBY','/data1/oradata/MIN'
의 파라미터에서 ' A 부분','B 부분'에서 B부분이 자신의 primary DB의 경로를 말하고 A부분이 변환할 standby DB의 경로를 말한다. 파라미터를 확인해보자.

fal_server, fal_client 는 standby DB에서만 사용한다. fal_server는 primary DB를 설정하고 fal_client는 standby DB를 설정해둔다. 이것을 설정할 경우 primary DB와 standby DB에 redo log의 gap이 발생했을 경우 자동으로 맞추어주는 역할을 한다.
fal_server=MIN
fal_client=STBY
lock_name_space는 한 대의 서버에서 primary, standby DB를 운영할 경우 사 용한다. 앞에서 말한 바와 같이 primary , standby DB
db_name은 같으며 instance_name(SID)만 다를 뿐이다. 같은 DB이름을 가진 instance를 한 대의 서버에서 기동하기 위해서는
lock_name_space를 지정해 주어야 한다. 만약 두 대의 서버에서 구성한다면 lock_name_space파라미터는 지정할 필요가 없다.
이것은 standby DB에서만 지정한다.
lock_name_space=STBY

 4) primary DB를 online backup으로 standby DB 위치로 restore

    <MIN DB primary DB>

- primary DB를 24시간 서비스 이므로 shutdown이 불가능한 것을 가정하에 구성한다.
- primary DB를 online backup으로 복사한다.
- online backup을 하는 것이므로 primary DB의 redo log는 standby DB로 전송하지 않는다. standby DB구성 시 자동으로
standby DB에서 redo log가 생성된다.

SQL> select tablespace_name, file_name, bytes/1024/1024 mega from dba_data_files; 

TABLESPACE_NAME	FILE_NAME	MEGA
------------------------------------------------------------------------------------------------------------
SYSTEM	/data1/oradata/MIN/system01.dbf	250
UNDOTBS	/data1/oradata/MIN/undotbs.dbf	100
USERS	/data1/oradata/MIN/users01.dbf	100

SQL> select name , bytes/1024/1024 mega from v$tempfile;

NAME	MEGA
------------------------------------------------------------
/data1/oradata/MIN/temp01.dbf	100

- 여기서는 cp 명령이 standby DB로 전송하는 것을 뜻한다. ftp로 primary db의 백업을 전송한다.
   SQL> alter tablespace system begin backup;
   SQL> !cp /data1/oradata/MIN/system01.dbf /data1/oradata/STBY/system01.dbf
   SQL> alter tablespace system end backup;
   SQL> alter tablespace undotbs begin backup;
   SQL> !cp /data1/oradata/MIN/undotbs.dbf /data1/oradata/STBY/undotbs.dbf
   SQL> alter tablespace undotbs end backup;
   SQL> alter tablespace users begin backup;
   SQL> !cp /data1/oradata/MIN/users01.dbf /data1/oradata/STBY/users01.dbf
   SQL> alter tablespace users end backup;

- tempfile은 그대로 복사를 한다. begin backup, end backup 이 필요 없다. 단 tempfile 이어야 한다.
   SQL> !cp /data1/oradata/MIN/temp01.dbf /data1/oradata/STBY/temp01.dbf

 5) primary DB에서 standby control file을 생성해서 standby DB로 전송

    <MIN DB primary DB>

- primary DB에서 standby control file을 생성해서 standby DB로 전송한다
   SQL> alter database create standby controlfile as '/data1/oradata/STBY/stbyctl.ctl';

 6) standby DB에서 사용할 control file을 배치

    <STBY DB standby DB의 control file>

- standby DB에서 사용할 control file을, standby DB의 초기화 퍼라미터(initSTBY.ora)파일에 있는 control file 위치에 배치한다.
SQL> !cp /data1/oradata/STBY/stbyctl.ctl /data1/oradata/STBY/control01.ctl
SQL> !cp /data1/oradata/STBY/stbyctl.ctl /data1/oradata/STBY/control02.ctl

 7) standby DB 기동

    <STBY DB standby DB 에서 수행>

- standby DB를 기동시킨다. startup mount standby database 라는 명령은 없다. nomount까지 기동한 후 standby DB로 mount를 한다.

   SQL> startup nomount
   SQL> alter database mount standby database;

 8) standby DB에 standby redo log file 생성

    <STBY DB standby DB에서 수행>

우리는 처음으로 standby DB를 구성하였으므로 standby redo log를 추가해 주어야 한다.
여기서 중요한 것은 primary redo log와 standby redo log가 같은 크기를 가지고 있어야 한다.
만약 다를 경우에는 차후에 ORA-16139 media recovery required
에러가 발생하면서 takeover나 failover가 정상적으로 수행되지 않을 수 있다.

SQL> select * from v$logfile;

GROUP#	STATUS TYPE	MEMBER
---------------------------------------------------------------
1	ONLINE	/data1/oradata/STBY/log01a.log
2	ONLINE	/data1/oradata/STBY/log02a.log
3		/data1/oradata/STBY/log03a.log

SQL> alter database add standby logfile
           '/data1/oradata/STBY/stbylog01a.log' size 10M;
SQL> alter database add standby logfile
           '/data1/oradata/STBY/stbylog02a.log' size 10M;
SQL> alter database add standby logfile
           '/data1/oradata/STBY/stbylog03a.log' size 10M;
SQL> select * from v$logfile;

GROUP#STATUS	TYPE	MEMBER
------------------------------------------------------------------
1	ONLINE	/data1/oradata/STBY/log01a.log
2	ONLINE	/data1/oradata/STBY/log02a.log
3	ONLINE	/data1/oradata/STBY/log03a.log
4	STANDBY	/data1/oradata/STBY/stbylog01a.log
5	STANDBY	/data1/oradata/STBY/stbylog02a.log
6	STANDBY	/data1/oradata/STBY/stbylog03a.log

 9) primary DB에 standby redo log file 생성

    <MIN DB primary DB 에서 수행>

서버문제가 발생했을 경우 takeover를 해야 하므로 primary DB도 standby DB가 될 수 있기 때문에
미리 standby redo log를 만든다.

SQL> select * from v$logfile;

GROUP#>	STATUS TYPE	MEMBER
---------------------------------------------------------------
1	ONLINE	/data1/oradata/MIN/log01a.log
2	ONLINE	/data1/oradata/MIN/log02a.log
3	ONLINE	/data1/oradata/MIN/log03a.log

SQL> alter database add standby logfile
          '/data1/oradata/MIN/stbylog01a.log' size 10M;
SQL> alter database add standby logfile
          '/data1/oradata/MIN/stbylog02a.log' size 10M;
SQL> alter database add standby logfile
          '/data1/oradata/MIN/stbylog03a.log' size 10M;

SQL> select * from v$logfile;

GROUP#	STATUS TYPE	MEMBER
-------------------------------------------------------------
1	ONLINE	/data1/oradata/MIN/log01a.log
2	ONLINE	/data1/oradata/MIN/log02a.log
3	ONLINE	/data1/oradata/MIN/log03a.log
4	STANDBY	/data1/oradata/MIN/stbylog01a.log
5	STANDBY	/data1/oradata/MIN/stbylog02a.log
6	STANDBY	/data1/oradata/MIN/stbylog03a.log

 10) standby DB를 recovery managed mode로 기동

    <STBY DB standby DB 에서 수행>

standby DB를 recovery managed mode로 변경한다.
standby DB서버에서 MRP 프로세스가 생긴다.

   SQL> recover managed standby database disconnect;

 11) log switch 적용

    <MIN DB primary DB 에서 수행>

standby DB를 구성하는 동안 primary DB와 gap이 생겼을 것이다.
current redo log를 적용시킨다.

   SQL> alter system archive log current;

 12) primary DB 점검

            PROCESS STATUS
           ------------- ---------------
           ARCH       CLOSING
          ARCH       CLOSING
           LGWR       WRITING SQL> select dest_id "ID",destination,status,target, schedule,process,mountid mid from v$archive_dest order by dest_id;
=> destination 2번에 우리는 service=STBY로 설정하였다. STBY는 tnsnames.ora에 나오는 접속이름이었다. STATUS=VALID 상태이고 STANDBY 이어야 한다.


=> 아무런 에러도 나와서는 안된다. 여기에서 에러가 났다면 primary DB를 먼저 기동하고 standby DB를 기동했을 경우 발생할 수도 있으나, standby로 전송이 안된 것일 수도 있으므로 다른 것도 확인을 해보아야 한다. 만약 standby DB를 먼저 기동하고 recovery managed mode에서 MRP 프로세스를 띄우고 그리고 나서야 primary DB를 기동시켰다면 아래에서는 아무런 메세지도 나와서는 안된다. 예제에서는 primary DB를 먼저 기동했으므로 메세지가 발생했을 것이다.

        MESSAGE         TIMESTAMP
        --------------------------
        --------------------------- SQL> select dest_id id,database_mode db_mode,recovery_mode, protection_mode,standby_logfile_count "SRLs", standby_logfile_active ACTIVE, archived_seq# from v$archive_dest_status;
==> db_mode가 MOUNTED_STANDBY 이어야 한다. recovery_mode 가 managed가 되어 있어야 primary DB에서 전송된 redo log정보를 standby DB에 적용시킬 수 있다.

        ID DB_MODE         RECOVER PROTECTION_MODE      SRLs ACTIVE ARCHIVED_SEQ#
        --- --------------- ------- -------------------- ---- ------ -------------
       1 OPEN            IDLE    MAXIMUM PERFORMANCE     0      0        45
       2 MOUNTED-STANDBY MANAGED MAXIMUM AVAILABILITY    2      0        45
       3 OPEN            IDLE    MAXIMUM PERFORMANCE     0      0         0

13) standby DB 점검
14) primary DB 테이블스페이스 생성 및 데이터 입력
        <MIN DB primary DB>
test 테이블스페이스를 만들고 테이블을 만들고 데이터를 넣어본다. 주의할 것은 db_file_name_convert 에서 나오는 것처럼 /data1/oradata/MIN 안에만 생성을 해야 한다. 그래야 standby DB에 데이터파일이 자동으로 생기게 된다.
또한 파라미터에서 standby_file_management=auto로 되어 있어야 standby DB에 테이블스페이스의 데이터파일이 생긴다.
SQL> create tablespace test datafile '/data1/oradata/MIN/test01.dbf' size 10M; SQL> select tablespace_name, file_name, bytes/1024/1024 mega from dba_data_files;

            

15) standby DB예 데이터 입력 여부 확인 <STBY DB standby DB>
- primary DB에서 만든 테이블스페이스가 있는지 데이터는 들어갔는지 확인한다.
recovery managed mode를 해제하고 read only로 open한다.
SQL> recover managed standby database cancel; SQL> alter database open read only;
==> 정상적으로 primary DB에서 만든 테이블스페이스가 적용되었으며, test 라는 테이블에 데이터 insert가 정상적으로 된 것을 확인할 수 있다.


- 다시 recovery managed mode로 만들어서 primary 에서 전송된 redo log 정보가 standby DB에 적용되도록 한다. fal_server, fal_client 파라미터가 설정되어 있으므로 자동으로 gap이 생긴 부분을 맞추어 준다.
DB를 open 상태에서도 recovery managed mode로 변경이 가능하다.
SQL> recover managed standby database disconnect;
16) takeover
시스템 문제가 발생하였다. takeover를 수행한다.
①<MIN DB primary DB>
가장 먼저 primary DB를 standby로 변경을 한 후 standby DB를 primary DB로 변경 해야한다. standby DB를 primary로 먼저 변경하면 primary DB가 standby DB로될 때까지 기다리게 된다.
이제 primary DB를 standby DB로 변경한 후 기존의 primary DB를shutdown 한다.
SQL> alter database commit to switchover to physical standby with session shutdown wait; SQL> shutdown immediate
② <STBY DB standby DB>
standby DB를 primary DB로 바꾸고 shutdown 한다. 유저접속은 없으므로 with session shutdown 절은 안 들어가도 된다.
SQL> alter database commit to switchover to primary; SQL> shutdown immediate
③ 파라미터를 변경한다. # 을 붙인 것을 빼거나 추가해서 설정해준다.
<MIN DB primary DB>

vi $ORACLE_HOME/dbs/initMIN.ora <변경전> #####standby DB이면 열고, primary DB이면 닫는다. #fal_server=STBY #fal_client=MIN #lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. log_archive_dest_2='SERVICE=STBY LGWR SYNC' <변경후> #####standby DB이면 열고, primary DB이면 닫는다. fal_server=STBY fal_client=MIN lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. #log_archive_dest_2='SERVICE=STBY LGWR SYNC'

<STBY DB standby DB>

>vi $ORACLE_HOME/dbs/initSTBY.ora <변경전> ##standby 이면 열고, primary DB이면 닫는다. fal_server=MIN fal_client=STBY lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. #log_archive_dest_2='SERVICE=MIN LGWR SYNC' <변경후> ##standby 이면 열고, primary DB이면 닫는다. #fal_server=MIN #fal_client=STBY #lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. #log_archive_dest_2='SERVICE=MIN LGWR SYNC'

④ <MIN DB , new standby DB> - 새롭게 standby DB가 된 MIN DB를 recovery managed mode로 변경한다. SQL> startup nomount SQL> alter database mount standby database; SQL> recover managed standby database disconnect; SQL> select process, status from v$managed_standby; ==> MRP 프로세스 기동 확인

        PROCESS STATUS
        ---------------- ------------
        ARCH    CONNECTED
        ARCH    CONNECTED
       MRP0    WAIT_FOR_LOG
     RFS     WRITING
     RFS     ATTACHED

⑤ <STBY DB, new primary DB> - new primary DB를 기동한다. SQL> startup
- 확인하기 SQL> select i.instance_name, i.status instance_status, d.name dbname, d.database_role db_role, d.switchover_status switchover_status , d.protection_mode from v$database d, v$instance i;
=> 중요한 점검포인트 이다. TO_STANDBY 인지 확인한다.

   

(17) 서비스 원복(takeover) 다시 원복을 시킨다. STBY DB를 standby DB로 변경한 후 MIN DB를primary DB로 변경한다.

<STBY DB, new primary DB> - primary DB를 standby DB로 만들고 나서 standby DB를 primary DB로 만든다.
순서를 잊지 말자.
SQL> alter database commit to switchover to physical standby with session shutdown wait; SQL> shutdown immediate
<MIN DB new standby DB> - MIN DB를 primary DB로 변경한다. SQL> alter database commit to switchover to primary ; SQL> shutdown immediate
<MIN DB primary DB> - 초기화 파라미터를 변경한다.

vi $ORACLE_HOME/dbs/initMIN.ora <원복시킨다> #####standby DB이면 열고, primary DB이면 닫는다. #fal_server=STBY #fal_client=MIN #lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. log_archive_dest_2='SERVICE=STBY LGWR SYNC'

<STBY DB standby DB>

vi $ORACLE_HOME/dbs/initSTBY.ora <원복시킨다> ##standby 이면 열고, primary DB이면 닫는다. fal_server=MIN fal_client=STBY lock_name_space=STBY ##primary DB이면 열고, standby DB이면 닫는다. #log_archive_dest_2='SERVICE=MIN LGWR SYNC'

18) failover
- primary DB가 있는 건물이 무너지고 디스크 이상으로 인해서 DB 데이터파일이 손상되었다.
standby DB를 긴급하게 기동시켜야 한다. MIN DB를 shutdown abort로 Down시키고(디스크 fail 장애),
standby DB를 primary DB로 기동시킨다.

- failover을 한 후에 시스템을 복구해서 MIN DB를 primary DB, STBY DB를 standby DB로 원래대로 구성하려면 Dataguard를 재구성 해야 한다.

즉, failover을 했다면 failover이후에 new primary DB인 STBY DB를 통해서 MIN DB를 standby DB로 구성하고
takeover 시키면 된다.

<MIN DB primary DB>
- 디스크장애상황
SQL> shutdown abort

<STBY DB standby DB>
- recovery managed mode를 해제(cancel)가 아닌 끝내도록(finish) 한다. primary DB로 변경한다.
SQL> recover managed standby database finish;
SQL> alter database commit to switchover to primary;
$ORACLE_HOME/dbs/initSTBY.ora 파일에서 primary DB로 파라미터를 설정하고 기동한다.
SQL> startup

<주의> 만약 standby DB인 STBY DB를 primary DB로 failover하던 도중 ORA-16139 media recovery required
에러가 나면서 recovery 하라고 나온다면?

이럴 경우엔 아래와 같은 명령을 사용하도록 한다.
Log stream을 standby DB에 적용하지 못한 경우에 발생할 수 있다.
이러한 사항은 여러 문제로 인해서 발생할 수 있으므로 발생했다면 오라클에 공식적으로 문의 해야한다.
아래와 같이 skip하면 skip하는 만큼의 gap을 DB에 적용하지 못할 수 있으니 주의해야 한다.
SQL> alter database recover managed standby database finish skip wait;
SQL> alter database commit to switchover to primary;
$ORACLE_HOME/dbs/initSTBY.ora 파일에서 primary DB로 파라미터를설정하고 기동한다.
SQL> startup

[출처] [본문스크랩] Oracle9i Dataguard 구성 방법 |작성자 이정현

//tnsnames.ora : 클라이언트 측 설정

# tnsnames.ora Network Configuration File: C:\oracle\product\10.2.0\db_2\Hsck\NETWORK\ADMIN\tnsnames.ora
# Generated by Oracle configuration tools.

RESP =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = TCP)(HOST = IP_ADDRESS)(PORT = PORT_NUMBER))
    )
    (CONNECT_DATA =
      (SERVICE_NAME = SIP)    
    )  
  )

EXTPROC_CONNECTION_DATA =
  (DESCRIPTION =
    (ADDRESS_LIST =
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC0))
    )
    (CONNECT_DATA =
      (SID = PLSExtProc)
      (PRESENTATION = RO)
    )
  )

////////////////////////////////////////////////////

//listener.ora ; Server 측 설정

# listener.ora Network Configuration File: C:\oracle\product\10.2.0\db_2\Hsck\network\admin\listener.ora
# Generated by Oracle configuration tools.

SID_LIST_LISTENER =
  (SID_LIST =
    (SID_DESC =    
     (SID_NAME = PLSExtProc)
      (ORACLE_HOME = C:\oracle\product\10.2.0\db_2\Hsck)
      (PROGRAM=PLSExProc)
    )  
  )

LISTENER =
  (DESCRIPTION_LIST =
    (DESCRIPTION =
      (ADDRESS = (PROTOCOL = TCP)(HOST = b)(PORT = 1521))
      (ADDRESS = (PROTOCOL = IPC)(KEY = EXTPROC0))
      (
       (CONNECT_DATA =
        (SERVICE_NAME = RESP)    
        (SID_NAME=RESP)
    )
    )
  )

PreparedStatement 를 이용

<%@ page import = "java.sql.PreparedStatement" %>

<%

String query = "select ? from table_name where x = ?";

PreparedStatement pstmt = conn.prepareStatement(query);

pstmt.setString(1, value_1);

pstmt.setString(2, value_2);

pstmt.close();

>%

Statement를 이용

<%@ page import = "java.sql.Statement" %>

<%

String query = "select ? from table_name where x = ?";

Statement stmt = conn.createStatement();

stmt.executeUpdate(query);

stmt.close();

%>

• server.xml 파일에 아래의 내용을 추가/변경한다.

MySQL 기반

<Context docBase="프로젝트이름" path="/프로젝트이름" reloadable="true" source="org.eclipse.jst.j2ee.server:프로젝트이름">
     
           <Resource name="jdbc/MySQL" auth="Container" type="javax.sql.DataSource"
           maxActive="5" maxIdle="3" maxWait="10000" username="접속할유저" password="접속할유저의비밀번호"
           driverClassName="com.mysql.jdbc.driver.OracleDriver" url="jdbc:mysql://ip_address:3306/접속할DB이름?toReconnect=true"/>
     
</Context>

오라클 기반

<Context docBase="프로젝트이름" path="/프로젝트이름" reloadable="true" source="org.eclipse.jst.j2ee.server:프로젝트이름">
     
           <Resource name="jdbc/oracle" auth="Container" type="javax.sql.DataSource"
           maxActive="5" maxIdle="3" maxWait="10000" username="접속할유저" password="접속할유저의비밀번호"
           driverClassName="oracle.jdbc.driver.OracleDriver" url="jdbc:oracle:thin:@ip_address:1521:sid"/>
     
</Context>

• web.xml에 추가할 내용

<resource-ref>

<res-ref-name>jdbc/mysql</res-ref-name>

<res-type>javax.sql.DataSource</res-type>

<res-auth>Container</res-auth>

</resource-ref>

• jsp 파일에 추가될 내용

<%@ page import = "java.sql.*, javax.sql.*, javax.naming.*" %>

<%
    Context ct = new InitialContext();
    DataSource ds = (DataSource)ct.lookup("java:comp/env/jdbc/oracle");
    Connection conn = ds.getConnection();
 %>

이 글은 인터넷 검색을 통해서 정리했음을 밝힙니다.

WAS(Web Application Server)란?Server)란?
-데이터베이스 조회나 일반적인 비즈니스 로직에 대한 처리를 위해 다양한 언어로 개발된개발된 인터넷/인트라넷 환경의 소프트웨어를 지짗한다.
-서버기반의 application system을 위한 최적화된 실행환경을실행환경을 제공하는 엔진
-Web Server와 DBMS를 연계 3-tier을 구현하는 Middle ware
-Web-Web 비지니스 로직을 구현하는 가장 효과적인 Solution

WAS의 기능
- 웹웹 환경에서의 최적의 트랜잭션 처리
- 웹 기반 애플리케이션들에 대한 분석 처리처리
- 분산된 웹 기반 어플리케이션 통합관리
- 웹 환경에서의 트랜잭션 모니터링모니터링

WAS의 역할
- 웹서버는 사용자(클라이언트)가 요청을 보내오면 그 명령에 대한대한 처리를 실행하고 다시 사용자에게 답변을 보내주는 역할을 수행합니다. 그런데 요청한 것들것들 중에 자체적으로 처리할 수 없는 것들을 톰캣과 같은 컨테이너나 아님 phpphp 모듈과 같이 처리할 수 있는 곳으로 넘겨 처리 결과를 받아와서 사용자에게사용자에게 넘겨주는 역할을 수행하는게 꼭 해야되는 기능 중에 하나입니다.

톰켓은 jsp를jsp를 실행 할 수 있는 컨테이너입니다. 웹서버에서 jsp를 요청하면 톰켓에서는 jsp파일을 servlet으로servlet으로 변환하여 컴파일을 수행하고 서블릿의 수행 결과를 웹서버에 전달하게 됩니다.

-- Tomcat
Java진영 Open Source Group인 Apache Software Foundation에서 공식적으로 사용하고사용하고 있는 Servlet-Container입니다.
또 Web server인 Apache의 기능을 내장하고 있어서, 그 자체로도자체로도 Web server기능을 할 수 있습니다. 하지만 분명히 톰캣은 WAS입니다.
(참고: IIS의IIS의 경우에는 출발은 web server이었는데, WAS로 구분하지 않고 그 자체로 WAS기능으로 포함시켜포함시켜 왔습니다. 그래서 구분하자면 Web+WAS입니다.)

- 밴더별 WAS
크게 마이크로소프트 플랫폼과플랫폼과 비 마이크로소프트 플랫폼으로 나뉘어 볼 수 있다.
비 마이크로소프트 플랫폼은 유닉스나 솔라리스 등의 운영체제에 오라클 DBMS, 그리고 별도의 미들웨어 제품을 얹어서 사용하며, 이 때문에 비 마이크로 소프트 플랫폼은 하나같이 표준 J2EE스펙을 완벽하게 준수한다는 사실을 장점으로 내세움.

- JSP가 컴파일되어컴파일되어 Servlet에 적재되는 시점
더 자세한 정보는 링크를 통해..

[출처][출처] JSP가 컴파일되어 Servlet Container에 적재되는 시점|작성자 행복마녀

http://blog.naver.com/tjddhr1168/10026420652

클라이언트에서 JSP를 요청했을 때 해당 JSP의 Servlet 객체가 ServletServlet 컨테이너에 있는지 없는지 검사하게 되고, 있다면 바로 실행에 들어가지만 없다면 다시다시 Servlet 생성루틴을 거치게 됩니다. 만약, 여러분이 JSP파일을 수정하였다면 Java Server Page는Page는 수정 검사루틴을 가지고 있기 때문에 JSP파일이 수정되었는지 검사한 후 수정되었다면 .jsp파일을.jsp파일을 .class로 컴파일하고 Servlet Container에 다시 적재하는 과정을 밟게 됩니다. 다음의 그림은그림은 JSP실행루틴을 도식화한 그림입니다.

위의 그림은 JSP의 작업작업 흐름도를 보여 주고 있습니다. 제일 먼저 Webserver나 Servlet 엔진에서 클라이언트의 요청을요청을 받게 됩니다. 서버에서 요청을 받게되면 바로 JSP Handler즉, JSP Container Process라고Process라고 불리우는 루틴을 거치게 되면서 Servlet 객체존재여부와 파일변경여부를 확인하게 됩니다. 변경되었다면 새로새로 source파일을 생성하고 그리고 compile과정을 거쳐 실행하게 되고 그리고 이미 로딩되어 있는데있는데 변경처리되지 않았다면 기존에 존재하는 것을 이용하게 됩니다. 로딩을 하지않았다면 처음부터 로딩을로딩을 시작하여 source파일을 만들고 compile과정을 거쳐 새로 실행합니다. 다른 서블릿들도 Servlet Container에Container에 적재하는 과정을 반복하게 됩니다.

<noscript> 태그는 브라우저에서 <script> 태그가 작동하지 않을 때 대신 내보낼 내용을 담기 위해 쓰인다.

즉, 방문객이 브라우저에서 자바스크립트가 실행되도록 설정해 두었다면 자바스크립트는 실행되고 <noscript> 태그 안의 내용은 나오지 않는다. 하지만 자바스크립트 기능을 꺼두고 있다면 자바스크립트가 실행되지 않는 대신에 <noscript> 태그 안의 내용이 출력된다.

<script type="text/javascript">
document.write('안녕하십니까?')
</script>
<noscript><p>자바스크립트를 꺼두셨군요.</p></noscript>

위의 예에서, 보통은 자바스크립트가 실행되기 때문에 화면에는 다음 문장이 나올 것이다.

하지만 자바스크립트가 실행되지 않는다면 화면에는 다음 문장이 나오게 된다.

브라우저에서 자바스크립트 기능을 꺼두고 쓰는 사람도 있기 때문에 자바스크립트를 쓴 곳에는 <noscript> 태그를 써서 자바스크립트가 필요하다는 걸 알려주는 게 좋다.

<p><a href="#" onclick="window.open('photo.html'; return false">사진 보기</a></p>
<noscript><p>사진 보기를 하려면 자바스크립트가 필요합니다.</p></noscript>

위 예에서는 자바스크립트를 써서 사진 보기 창을 뜨도록 하고 있으므로, 자바스크립트를 꺼두면 새 창을 뜨게 할 수 없기 때문에 사진을 볼 수 없다. 만약 <noscript> 태그를 쓰지 않는다면 모르는 사람은 왜 사진 보기가 안 되는 걸까 의아해 할지도 모른다. 하지만 <noscript> 태그를 써서, 위와 같이 사진을 보기 위해서는 자바스크립트가 필요하다는 걸 알려준다면 자바스크립트 기능을 꺼두었기 때문에 사진 보기가 안 된다는 걸 알고 사진을 보기 위해 자바스크립트 기능을 켜게 될 것이다.

위 코드의 결과는 다음과 같다. 브라우저에서 자바스크립트 기능을 꺼서 어떻게 보이는지 직접 확인해 보기 바란다.

사진 보기

참고로 photo.html 파일은 만들지 않았으므로 사진 보기를 눌러도 새 창은 뜨지 않을 것이며, <noscript> 태그 안의 글씨는 현재 이곳의 CSS 설정에 따라 크기나 색깔이 다르게 보일 수도 있다.

<noscript> 태그 안의 내용은 웹 문서의 내용과는 상관 없는 것이므로 웹 문서의 내용과는 다르게 보이도록 하는 게 좋다. 예를 들어, CSS에서 설정을 다음과 같이 해 두면 <noscript> 태그 안의 글씨는 돋움 글꼴에 본문 글씨보다 작게 녹색으로 보이게 되므로 웹 문서에 쓰인 글씨가 검은 색이면 서로 구별될 것이다.

noscript { font-family: 돋움, Dotum; 
           font-size: 75%; 
           color: green; }

끝으로 한 가지 주의사항은, <noscript> 태그는 <p> 태그를 감쌀 수 있지만 그 반대는 되지 않고, <noscript> 태그 안에 들어 있는 글씨를 <p> 같은 형님 태그로 감싸주지 않으면 웹 표준 검사에서 오류가 난다는 것이다.

java.io
클래스 PrintWriter

java.lang.Object 
  java.io.Writer 
      java.io.PrintWriter

모든 구현된 인터페이스:

Closeable , Flushable , Appendable

객체의 서식 첨부 표현을 텍스트 출력 스트림에 출력합니다. 이 클래스는,PrintStream 에 있는 print 메소드를 모두 구현합니다. 다만, raw 바이트를 기입하는 메소드는 포함되지 않습니다. raw 바이트에 대해서는, encode되어 있지 않은 바이트 스트림을 프로그램으로 사용해 주세요.

PrintStream 클래스와는 달라, 자동 플래시가 유효한 경우는, 개행 문자가 출력될 때는 아니고,println,printf,format 의 몇개의 메소드가 불려 갔을 때에 마셔 실행됩니다. 이러한 메소드는, 개행 문자는 아니고, 플랫폼에 고유의 행 단락의 표기를 사용합니다.

이 클래스의 메소드는, 생성자 의 일부를 제외해, 입출력 예외를 throw 할 것은 없습니다. 클라이언트는,checkError() 를 호출하는 것에 의해, 에러가 발생했는지의 여부를 조회할 수 있습니다.

도입된 버젼:

JDK1. 1

---

필드의 개요
protected  Writer	out           이 PrintWriter 의 기본이 되는 문자 출력 스트림입니다.

 

클래스 java.io. Writer 로부터 상속된 필드
lock

 

생성자 의 개요
PrintWriter (File  file)           행의 자동 플래시는 실시하지 않고 , 지정된 파일로 새로운 PrintWriter 를 작성합니다.
PrintWriter (File  file, String  csn)           행의 자동 플래시는 실시하지 않고 , 지정된 파일과 캐릭터 세트로 새로운 PrintWriter 를 작성합니다.
PrintWriter (OutputStream  out)           행의 자동 플래시는 실시하지 않고 , 기존의 OutputStream 로부터 새로운 PrintWriter 를 작성합니다.
PrintWriter (OutputStream  out, boolean autoFlush)           기존의 OutputStream 로부터 새로운 PrintWriter 를 작성합니다.
PrintWriter (String  fileName)           행의 자동 플래시는 실시하지 않고 , 지정된 파일명으로 새로운 PrintWriter 를 작성합니다.
PrintWriter (String  fileName, String  csn)           행의 자동 플래시는 실시하지 않고 , 지정된 파일명과 캐릭터 세트로 새로운 PrintWriter 를 작성합니다.
PrintWriter (Writer  out)           행의 자동 플래시는 실시하지 않고 , 새로운 PrintWriter 를 작성합니다.
PrintWriter (Writer  out, boolean autoFlush)           새로운 PrintWriter 를 작성합니다.

 

메소드의 개요
PrintWriter	append (char c)           지정된 문자를 이 라이터에 추가합니다.
PrintWriter	append (CharSequence  csq)           지정된 문자 순서를 이 라이터에 추가합니다.
PrintWriter	append (CharSequence  csq, int start, int end)           지정된 문자 순서의 서브 순서를 이 라이터에 추가합니다.
boolean	checkError ()           스트림이 닫혀지지 않은 경우는, 그 스트림을 플래시 해, 에러 상태를 체크합니다.
protected  void	clearError ()           이 스트림의 에러 상태를 해제합니다.
void	close ()           스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다.
void	flush ()           스트림을 플래시 합니다.
PrintWriter	format (Locale  l, String  format, Object ... args)           지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다.
PrintWriter	format (String  format, Object ... args)           지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다.
void	print (boolean b)           boolean 형의 값을 출력합니다.
void	print (char c)           문자를 출력합니다.
void	print (char[] s)           문자의 배열을 출력합니다.
void	print (double d)           배정밀도의 부동 소수점수(실수)를 출력합니다.
void	print (float f)           부동 소수점수(실수)를 출력합니다.
void	print (int i)           정수를 출력합니다.
void	print (long l)           long 정수를 출력합니다.
void	print (Object  obj)           객체를 출력합니다.
void	print (String  s)           캐릭터 라인을 출력합니다.
PrintWriter	printf (Locale  l, String  format, Object ... args)           지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다.
PrintWriter	printf (String  format, Object ... args)           지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다.
void	println ()           행의 단락 캐릭터 라인을 기입하는 것으로, 현재의 행을 종료시킵니다.
void	println (boolean x)           boolean 치를 출력해, 행을 종료시킵니다.
void	println (char x)           문자를 출력해, 행을 종료시킵니다.
void	println (char[] x)           문자의 배열을 출력해, 행을 종료시킵니다.
void	println (double x)           배정밀도 부동 소수점수(실수)를 출력해, 행을 종료시킵니다.
void	println (float x)           부동 소수점수(실수)를 출력해, 행을 종료시킵니다.
void	println (int x)           정수를 출력해, 행을 종료시킵니다.
void	println (long x)           long 형의 정수치를 출력해, 행을 종료시킵니다.
void	println (Object  x)           Object 를 출력해, 행을 종료시킵니다.
void	println (String  x)           캐릭터 라인을 출력해, 행을 종료시킵니다.
protected  void	setError ()           에러가 발생한 것을 나타냅니다.
void	write (char[] buf)           문자의 배열을 기입합니다.
void	write (char[] buf, int off, int len)           문자의 배열의 일부를 기입합니다.
void	write (int c)           단일의 문자를 기입합니다.
void	write (String  s)           캐릭터 라인을 기입합니다.
void	write (String  s, int off, int len)           캐릭터 라인의 일부를 기입합니다.

 

클래스 java.lang. Object 로부터 상속된 메소드
clone , equals , finalize , getClass , hashCode , notify , notifyAll , toString , wait , wait , wait

 

필드의 상세

out

protected Writer  out

이 PrintWriter 의 기본이 되는 문자 출력 스트림입니다.

도입된 버젼:

1.2

생성자 의 상세

PrintWriter

public PrintWriter(Writer  out)

행의 자동 플래시는 실시하지 않고 , 새로운 PrintWriter 를 작성합니다.

파라미터:

out - 문자 출력 스트림

---

PrintWriter

public PrintWriter(Writer  out,
                   boolean autoFlush)

새로운 PrintWriter 를 작성합니다.

파라미터:

out - 문자 출력 스트림

autoFlush - boolean 치. true 의 경우,println 메소드,printf 메소드, 또는 format 메소드는 출력 버퍼를 플래시 한다

---

PrintWriter

public PrintWriter(OutputStream  out)

행의 자동 플래시는 실시하지 않고 , 기존의 OutputStream 로부터 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간의 OutputStreamWriter 를 작성합니다. 이것은, 디폴트의 문자 인코딩을 사용해 문자를 바이트로 변환합니다.

파라미터:

out - 출력 스트림

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

---

PrintWriter

public PrintWriter(OutputStream  out,
                   boolean autoFlush)

기존의 OutputStream 로부터 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간의 OutputStreamWriter 를 작성합니다. 이것은, 디폴트의 문자 인코딩을 사용해 문자를 바이트로 변환합니다.

파라미터:

out - 출력 스트림

autoFlush - boolean 치. true 의 경우,println 메소드,printf 메소드, 또는 format 메소드는 출력 버퍼를 플래시 하는

관련 항목:

OutputStreamWriter.OutputStreamWriter(java.io.OutputStream)

---

PrintWriter

public PrintWriter(String  fileName)
            throws FileNotFoundException 

행의 자동 플래시는 실시하지 않고 , 지정된 파일명으로 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간 OutputStreamWriter 를 작성합니다. 이것은, 이 Java 가상 머신 인스턴스의디폴트 캐릭터 세트를 사용해, 문자를 encode 합니다.

파라미터:

fileName - 이 라이터의 행선지로서 사용되는 파일의 이름. 파일이 존재하는 경우는, 사이즈 0 에 절약할 수 있다. 그렇지 않은 경우는, 신규 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 넣어진다

예외:

FileNotFoundException - 지정된 캐릭터 라인이 기존의 파일을 나타내지 않는 경우, 기입해 가능한 일반적으로 파일 및 신규의 일반적으로 파일이 그 이름으로 작성할 수 없는 경우, 또는 파일의 오픈 또는 작성중에 그 외의 에러가 발생했을 경우

SecurityException - 시큐리티 매니저가 존재해,checkWrite(fileName) 가 파일에의 기입해 액세스를 거부했을 경우

도입된 버젼:

1.5

---

PrintWriter

public PrintWriter(String  fileName,
                   String  csn)
            throws FileNotFoundException ,
                   UnsupportedEncodingException 

행의 자동 플래시는 실시하지 않고 , 지정된 파일명과 캐릭터 세트로 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간 OutputStreamWriter 를 작성합니다. 이것은, 제공된 캐릭터 세트를 사용해 문자를 encode 합니다.

파라미터:

fileName - 이 라이터의 행선지로서 사용되는 파일의 이름. 파일이 존재하는 경우는, 사이즈 0 에 절약할 수 있다. 그렇지 않은 경우는, 신규 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 넣어지는

csn - 지원하는 charset 의 이름

예외:

FileNotFoundException - 지정된 캐릭터 라인이 기존의 파일을 나타내지 않는 경우, 기입해 가능한 일반적으로 파일 및 신규의 일반적으로 파일이 그 이름으로 작성할 수 없는 경우, 또는 파일의 오픈 또는 작성중에 그 외의 에러가 발생했을 경우

SecurityException - 시큐리티 매니저가 존재해,checkWrite(fileName) 가 파일에의 기입해 액세스를 거부했을 경우

UnsupportedEncodingException - 지정된 캐릭터 세트가 지원되어 있지 않은 경우

도입된 버젼:

1.5

---

PrintWriter

public PrintWriter(File  file)
            throws FileNotFoundException 

행의 자동 플래시는 실시하지 않고 , 지정된 파일로 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간 OutputStreamWriter 를 작성합니다. 이것은, 이 Java 가상 머신 인스턴스의디폴트 캐릭터 세트를 사용해, 문자를 encode 합니다.

파라미터:

file - 이 라이터의 행선지로서 사용되는 파일. 파일이 존재하는 경우는, 사이즈 0 에 절약할 수 있다. 그렇지 않은 경우는, 신규 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 넣어진다

예외:

FileNotFoundException - 지정된 파일 객체가 기존의 파일을 나타내지 않는 경우, 기입해 가능한 일반적으로의 파일 및 신규의 일반적으로 파일이 그 이름으로 작성할 수 없는 경우, 또는 파일의 오픈 또는 작성중에 그 외의 에러가 발생했을 경우

SecurityException - 시큐리티 매니저가 존재해,checkWrite(file.getPath()) 가 파일에의 기입해 액세스를 거부했을 경우

도입된 버젼:

1.5

---

PrintWriter

public PrintWriter(File  file,
                   String  csn)
            throws FileNotFoundException ,
                   UnsupportedEncodingException 

행의 자동 플래시는 실시하지 않고 , 지정된 파일과 캐릭터 세트로 새로운 PrintWriter 를 작성합니다. 이 간이 생성자 은, 필요한 중간 OutputStreamWriter 를 작성합니다. 이것은, 제공된 캐릭터 세트를 사용해 문자를 encode 합니다.

파라미터:

file - 이 라이터의 행선지로서 사용되는 파일. 파일이 존재하는 경우는, 사이즈 0 에 절약할 수 있다. 그렇지 않은 경우는, 신규 파일이 작성된다. 출력은 파일에 기입해져 버퍼에 넣어지는

csn - 지원하는 charset 의 이름

예외:

FileNotFoundException - 지정된 파일 객체가 기존의 파일을 나타내지 않는 경우, 기입해 가능한 일반적으로의 파일 및 신규의 일반적으로 파일이 그 이름으로 작성할 수 없는 경우, 또는 파일의 오픈 또는 작성중에 그 외의 에러가 발생했을 경우

SecurityException - 시큐리티 매니저가 존재해,checkWrite(file.getPath()) 가 파일에의 기입해 액세스를 거부했을 경우

UnsupportedEncodingException - 지정된 캐릭터 세트가 지원되어 있지 않은 경우

도입된 버젼:

1.5

메소드의 상세

flush

public void flush()

스트림을 플래시 합니다.

정의:

인터페이스 Flushable 내의 flush

정의:

클래스 Writer 내의 flush

관련 항목:

checkError()

---

close

public void close()

스트림을 닫아, 거기에 관련하는 모든 system resource를 해제합니다. 벌써 닫혀지고 있는 스트림을 닫아도, 무슨 영향도 없습니다.

정의:

인터페이스 Closeable 내의 close

정의:

클래스 Writer 내의 close

관련 항목:

checkError()

---

checkError

public boolean checkError()

스트림이 닫혀지지 않은 경우는, 그 스트림을 플래시 해, 에러 상태를 체크합니다.

반환값:

기본이 되는 출력 스트림상 또는 형식 변환중에, 출력 스트림로 에러가 검출되었을 경우는 true

---

setError

protected void setError()

에러가 발생한 것을 나타냅니다.

이 메소드를 사용하면(자),clearError() 가 불려 갈 때까지,checkError() 가 계속해 불려 가 true 가 돌려주어집니다.

---

clearError

protected void clearError()

이 스트림의 에러 상태를 해제합니다.

이 메소드를 사용하면(자), 다른 기입 처리가 실패해,setError() 가 불려 갈 때까지,checkError() 가 계속해 불려 가 false 가 돌려주어집니다.

도입된 버젼:

1.6

---

write

public void write(int c)

단일의 문자를 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

c - 기입하는 문자를 지정하는 int

---

write

public void write(char[] buf,
                  int off,
                  int len)

문자의 배열의 일부를 기입합니다.

정의:

클래스 Writer 내의 write

파라미터:

buf - 문자의 배열

off - 문자의 기입 개시 오프셋(offset)

len - 기입하는 문자수

---

write

public void write(char[] buf)

문자의 배열을 기입합니다. 입출력 예외를 억제해야 하기 때문에, 이 메소드를 Writer 클래스로부터 상속할 수 없습니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

buf - 기입하는 문자의 배열

---

write

public void write(String  s,
                  int off,
                  int len)

캐릭터 라인의 일부를 기입합니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

s - 캐릭터 라인

off - 문자의 기입 개시 오프셋(offset)

len - 기입하는 문자수

---

write

public void write(String  s)

캐릭터 라인을 기입합니다. 입출력 예외를 억제해야 하기 때문에, 이 메소드를 Writer 클래스로부터 상속할 수 없습니다.

오버라이드(override):

클래스 Writer 내의 write

파라미터:

s - 기입해지는 캐릭터 라인

---

print

public void print(boolean b)

boolean 형의 값을 출력합니다. String.valueOf(boolean) 에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

b - 출력되는 boolean 치

---

print

public void print(char c)

문자를 출력합니다. 문자는 플랫폼의 디폴트의 문자 인코딩에 따라 1 개 이상의 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

c - 출력되는 char 치

---

print

public void print(int i)

정수를 출력합니다. String.valueOf(int) 에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

i - 출력되는 int 치

관련 항목:

Integer.toString(int)

---

print

public void print(long l)

long 정수를 출력합니다. String.valueOf(long) 에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

l - 출력되는 long 치

관련 항목:

Long.toString(long)

---

print

public void print(float f)

부동 소수점수(실수)를 출력합니다. String.valueOf(float) 에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

f - 출력되는 float 치

관련 항목:

Float.toString(float)

---

print

public void print(double d)

배정밀도의 부동 소수점수(실수)를 출력합니다. String.valueOf(double) 에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

d - 출력되는 double 치

관련 항목:

Double.toString(double)

---

print

public void print(char[] s)

문자의 배열을 출력합니다. 문자는 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

s - 출력되는 char 의 배열

예외:

NullPointerException - s 가 null 의 경우

---

print

public void print(String  s)

캐릭터 라인을 출력합니다. 인수가 null 의 경우는, 캐릭터 라인 「null」가 출력됩니다. 그렇지 않은 경우, 캐릭터 라인의 문자는 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

s - 출력되는 String 치

---

print

public void print(Object  obj)

객체를 출력합니다. String.valueOf(Object) 메소드에 의해 작성된 캐릭터 라인은, 플랫폼의 디폴트의 문자 인코딩에 따라 바이트에 변환되어 이러한 바이트는 write(int) 메소드와 완전히 같은 방법으로 기입해집니다.

파라미터:

obj - 출력되는 Object 치

관련 항목:

Object.toString()

---

println

public void println()

행의 단락 캐릭터 라인을 기입하는 것으로, 현재의 행을 종료시킵니다. 행의 단락 캐릭터 라인은, 시스템 프로퍼티 line.separator 로 정의되어 반드시 단일의 개행 문자 ('\n')이다고는 할 수 없습니다.

---

println

public void println(boolean x)

boolean 치를 출력해, 행을 종료시킵니다. 이 메소드는,print(boolean) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 boolean 치

---

println

public void println(char x)

문자를 출력해, 행을 종료시킵니다. 이 메소드는,print(char) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 char 치

---

println

public void println(int x)

정수를 출력해, 행을 종료시킵니다. 이 메소드는,print(int) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 int 치

---

println

public void println(long x)

long 형의 정수치를 출력해, 행을 종료시킵니다. 이 메소드는,print(long) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 long 치

---

println

public void println(float x)

부동 소수점수(실수)를 출력해, 행을 종료시킵니다. 이 메소드는,print(float) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 float 치

---

println

public void println(double x)

배정밀도 부동 소수점수(실수)를 출력해, 행을 종료시킵니다. 이 메소드는,print(double) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 double 치

---

println

public void println(char[] x)

문자의 배열을 출력해, 행을 종료시킵니다. 이 메소드는,print(char[]) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 char 치의 배열

---

println

public void println(String  x)

캐릭터 라인을 출력해, 행을 종료시킵니다. 이 메소드는,print(String) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 String 치

---

println

public void println(Object  x)

Object 를 출력해, 행을 종료시킵니다. 이 메소드는, 최초로 String.valueOf(x)를 호출해, 출력된 객체의 캐릭터 라인치를 가져옵니다. 다음에,print(String) 를 호출하고 나서 println() 를 호출하는 것과 같이 동작합니다.

파라미터:

x - 출력되는 Object 치

---

printf

public PrintWriter  printf(String  format,
                          Object ... args)

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

이 메소드를 out.printf(format, args) 의 형식에서 호출하면(자), 다음의 호출과 같은 결과가 됩니다.

out.format(format, args) 

파라미터:

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

---

printf

public PrintWriter  printf(Locale  l,
                          String  format,
                          Object ... args)

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입하는 편리한 메소드입니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

이 메소드를 out.printf(l, format, args) 의 형식에서 호출하면(자), 다음의 호출과 같은 결과가 됩니다.

out.format(l, format, args) 

파라미터:

l - 서식 설정시에 적용하는로케일 . l 가 null 의 경우, 로컬라이제이션은 적용되지 않는

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

---

format

public PrintWriter  format(String  format,
                          Object ... args)

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

이 객체에 대해서 다른 서식 설정 메소드가 먼저 불려 가고 있었는지 어떠했는지에 관계없이,Locale.getDefault() 에 의해 반환되는 로케일이 항상 사용됩니다.

파라미터:

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

---

format

public PrintWriter  format(Locale  l,
                          String  format,
                          Object ... args)

지정된 서식 캐릭터 라인 및 인수를 사용해, 서식 첨부 캐릭터 라인을 이 라이터에 기입합니다. 자동 플래시가 유효한 경우는, 이 메소드를 호출하면(자) 출력 버퍼가 플래시 됩니다.

파라미터:

l - 서식 설정시에 적용하는로케일 . l 가 null 의 경우, 로컬라이제이션은 적용되지 않는

format - 「서식 캐릭터 라인의 구문」으로 설명한 서식 캐릭터 라인

args - 서식 캐릭터 라인내의 서식 지시자에 의해 참조되는 인수. 서식 지시자 이외에도 인수가 존재하는 경우, 여분의 인수는 무시된다. 인수의 수는 변동해, 제로의 경우도 있다. 인수의 최대수는,Java 가상 머신 스펙으로 정의된 Java 배열의 최대 사이즈의 제한을 받는다. 인수가 null 의 경우, 동작은변환에 응해 다르다

반환값:

이 라이터

예외:

IllegalFormatException - 서식 캐릭터 라인에 부정한 구문, 지정된 인수와 호환성이 없는 서식 지시자, 인수의 지정이 불충분한 서식 캐릭터 라인, 또는 다른 부정한 조건이 포함되는 경우. 가능성이 있는 서식 에러 모든 자세한 것은, Formatter 클래스 스펙의「상세」섹션을 참조

NullPointerException - format 가 null 의 경우

도입된 버젼:

1.5

---

append

public PrintWriter  append(CharSequence  csq)

지정된 문자 순서를 이 라이터에 추가합니다.

이 메소드를 out.append(csq) 의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.write(csq.toString()) 

문자 순서 csq 의 toString 의 스펙에 따라서는, 그 순서 전체가 추가되지 않을 가능성도 있습니다. 예를 들어, 문자 버퍼의 toString 메소드를 호출했을 경우, 그 버퍼의 위치와 리밋트에 의해 정해지는 내용을 가지는 서브 순서가 돌려주어집니다.

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 추가되는 문자 순서. csq 가 null 의 경우는, 이 라이터에 「null」라고 하는 4 문자가 추가된다

반환값:

이 라이터

도입된 버젼:

1.5

---

append

public PrintWriter  append(CharSequence  csq,
                          int start,
                          int end)

지정된 문자 순서의 서브 순서를 이 라이터에 추가합니다.

이 메소드를 out.append(csq, start, end) (csq 는 null 가 아니다)의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.write(csq.subSequence(start, end). toString()) 

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

csq - 문자 서브 순서의 추가원이 되는 문자 순서. csq 가 null 의 경우,csq 에 「null」의 4 문자가 포함되는것 같이 문자가 추가되는

start - 문자 서브 순서의 최초의 문자의 인덱스

end - 문자 서브 순서의 마지막 문자에 계속되는 문자의 인덱스

반환값:

이 라이터

예외:

IndexOutOfBoundsException - start 또는 end 가 0 보다 작은 값의 경우,start 가 end 보다 큰 경우, 또는 end 가 csq.length() 보다 큰 경우

도입된 버젼:

1.5

---

append

public PrintWriter  append(char c)

지정된 문자를 이 라이터에 추가합니다.

이 메소드를 out.append(c) 의 형식에서 호출했을 경우, 다음의 호출과 같은 결과를 얻을 수 있습니다.

out.write(c) 

정의:

인터페이스 Appendable 내의 append

오버라이드(override):

클래스 Writer 내의 append

파라미터:

c - 추가하는 16 비트 문자

반환값:

이 라이터

도입된 버젼:

1.5