Hash 형태의 오브젝트란? 
{ key : value }의 형태를 말하고 이해를 돕기 위해 Hash형 오브젝트라 칭합니다.
Hash형 오브젝트 타입은 value에는 다양한 type의 값이 올 수 있습니다.

위의 apply에 의해서 this에 config로 넘겨준 값이 모두 overwrite 되게 됩니다. this가 가지고 있던 속성 및 메서드까지 모두 config가 가지고 있던 값으로 치환되어집니다.

이때 apply 에 첫번째 인자로 주는 config 는 ExtJS에서는 해당 클래스가 갖는 속성의 의미와도 같습니다.

좀더 쉽게 풀이해서 쓴다면 ExtJS의 하나의 클래스가 인스턴스화 되어질 때 기본적으로 갖게 되는 속성 그리고 상속구조가 형성되면서 override 되는 속성과 메서드들의 기본 설정을 합니다.

좀더 쉬운 예를 들어보면 하나의 widget이 생성되어 브라우저에 띄울 때 그 widget의 기본 사이즈, 드래그 앤 드랍 등을 할 수 있는 설정을 이 config에 Hash 오브젝트로 넘겨주는 초기 설정값과도 같습니다.

more..

참고 : http://www.fusioncharts.com/

웹으로 통계를 이쁘게 그래프로 보여주고 싶은분들께 추천합니다.
물론 유료이긴 합니다만, 일부 그래프들은 이용 가능합니다.

필요한것은..
FusionCharts.js 자바스크립 파일과 그래프용 swf파일입니다.
(위 FusionChart 사이트에서 다운로드 가능합니다.)

아래와 같이 간단히 자바스크립트 코딩을 하면 이쁜 그래프가 나옵니다. ;-)
즉, FusionChart swf 파일에 맞는 xml 문서만 인자로 넘겨주면 됩니다.

<div id="chart1div"></div>
<script language="JavaScript" src="FusionCharts.js"></script>
<script type="text/javascript">
<!--
    var chart1 = new FusionCharts("Area2D.swf", "sampleChart1", "700", "350", "0", "1");
    chart1.setDataURL(XML페이지 주소);   
    chart1.render("chart1div");
-->
</script>

jQuery 개발자를 위한 메모 - 레퍼런스

레퍼런스

$()

jQuery 오브젝트를 만들어 내는 함수입니다.

$("CSS/Xpath 문자열")

CSS/XPATH 그리고 요소를 지정해, 매치한 요소를 가진다jQuery 오브젝트를 돌려줍니다. 자세한 지정 방법은 CSS / XPath (을)를 참조해 주세요.

var $toc_1 = $("#toc_1");

jquery_dump($toc_1);

var $h1 = $("h1");

jquery_dump($h1);

var $h1head = $("h1.head");

jquery_dump($h1head);

var $ahref = $("a[@href='http://jquery.com/']");

jquery_dump($ahref);

var $h1pa = $("//p/a");

jquery_dump($h1pa);

$(DOM 요소) / $([DOM 요소의] 배열)

지정했다DOM 요소를 가진다jQuery 오브젝트를 돌려줍니다.
each (이)나 콜백 함수로 this (을)를 나팔 하는 경우에 이용한다 사용법이 많다고 생각합니다.

$(function(){

    // 

초기화 코드

    $("#link").click(function(){

        alert(  $(this).html()  );

        return false;

    });

});

$(jQuery 오브젝트)

jQuery 오브젝트의 현재 상태와 같다DOM 요소 집합을 가졌다jQuery 오브젝트를 작성합니다.
jQuery 의 스택의 최신의DOM 요소 집합이 카피되어 스택의 모든 상태까지는 카피되지 않습니다. 또,DOM 요소 자체의 카피도 되지 않습니다.

$("CSS/Xpath 문자열", 문맥)

지정된 문맥 중(안)에서, 매치하는 요소를 가진다jQuery 오브젝트를 추출해, 돌려줍니다.
일부의 범위에 한해서 검색을 실시하고 싶은 경우에 이용할 수 있습니다.
이 단락에는 class="context_header" 하지만 지정되어 있습니다.

$("title",xml.reponseXML);

alert(  $("br", $(".context_header")).size()  );

jQuery 오브젝트 조작

jQuery 오브젝트는, 복수의DOM 요소를 가질 수 있습니다.0 개의 경우도 있습니다. 그러한DOM 요소에 관한 조작을 실시하는 메소드군입니다.

size() / length

DOM 요소의 수를 표시합니다.

var $target = $("#target_jquery_size");

alert(  $("p", $target).size()  );

var $target = $("#target_jquery_size");

alert(  $("p.header", $target).size()  );

var $target = $("#target_jquery_size");

alert(  $("p", $target).length  );

get()

DOM 요소를 배열로 취득합니다.

var $target = $("#target_jquery_get");

alert(  $("p", $target).get()  );

alert(  $("p", $target).get()[0]  );

get(N)

N 번째의DOM 요소를 취득합니다.

var $target = $("#target_jquery_get_N");

alert(  $("p", $target).get(0)  );

alert(  $("p", $target).get(1)  );

alert(  $("p", $target).get(2)  ); // 

존재하지 않는 경우는 undefined 

하지만 돌아간다

[N]

N 번째의DOM 요소를 취득합니다. get(N) (와)과 같습니다.

var $target = $("#target_jquery_get_N2");

alert(  $("p", $target)[0]  );

alert(  $("p", $target)[1]  );

alert(  $("p", $target)[2]  ); // 

존재하지 않는 경우는 undefined 

하지만 돌아간다

each( 함수)

각각의DOM 요소에 대해서, 지정한 함수를 실행합니다.
DOM 요소가this (이)가 되어 함수가 실행됩니다. jQuery 오브젝트로서 취급하고 싶은 경우는,$(this) (와)과 나팔 할 필요가 있습니다.

var $target = $("#target_jquery_each");

$("p", $target).each(function(){

    alert(  this  );

});

var $target = $("#target_jquery_each");

$("p", $target).each(function(){

    alert(  $(this).html()  );

});

이벤트

이벤트의 설정을 실시합니다. HTML (으)로의 onclick / onfocus 등과 같은 일을,JavaScript 옆으로부터 설정할 수 있습니다.
여기에서는 코어의 이벤트 기능에 대해 설명합니다만, 확장 이벤트라는 것이 있어, 이벤트를 보다 간단하게 설정하거나 마우스 오버등의 지원 기능이 있습니다.
bind/unbind 대신에, 확장 이벤트를 사용하는 것을 추천합니다.

bind(" 이벤트명", 함수)

대상 오브젝트에 관해서, 지정한 이벤트가 발생했을 때에, 함수를 호출하도록(듯이) 설정합니다.

unbind(" 이벤트명", 함수) / unbind(" 이벤트명")

대상 오브젝트에 관해서, 이벤트와의 묶어를 해제합니다.
함수를 지정하지 않았던 경우는, 모든 함수와의 묶어가 해제됩니다.

trigger(" 이벤트명")

대상 오브젝트에, 지정한 이벤트를 발생시킵니다.

DOM( 기본)

attr( 키) / attr( 키, 치) / attr( 해시) / removeAttr( 키)

DOM 요소의 속성을 조작합니다.
키만을 지정했을 경우는 취득, 키, 값으로의 지정이나, 해시로 지정했을 경우는, 그러한 설정치로 덧쓰기합니다. removeAttr() 의 경우는, 지정한 속성을 삭제합니다.
취득의 경우는, 최초의DOM 요소가 대상이 됩니다. 값을 설정하는 경우는, 모든DOM 요소가 대상이 됩니다.

var $target = $("#target_dom_attr");

var $p = $("p", $target);

alert(  $p.attr("class")  ); // 

최초의 요소가 대상

alert(  $target.html()  );

$p.attr("class", "danraku3"); // 

모든 요소가 대상

alert(  $target.html()  );

$p.removeAttr("class");

alert(  $target.html()  );

addClass( 클래스명) / removeClass( 클래스명) / toggleClass( 클래스명)

대상의DOM 요소에, 지정한 클래스를 추가·삭제, 혹은 타글 합니다.

var $target = $("#target_dom_class");

var $p = $("p", $target);

$p.addClass("addclass");

alert(  $target.html()  );

$p.toggleClass("danraku1");

alert(  $target.html()  );

text()

모든DOM 요소의 텍스트 컨텐츠를 이어 맞춘 문자열을 돌려줍니다.

var $target = $("#target_dom_text");

alert(  $target.text()  );

alert(  $target.html()  );

DOM( 속성)

jQuery 오브젝트는 복수의DOM 요소를 가집니다만,DOM 조작을 실시하는 경우, 조작 대상이 경우에 따라서 다른 것에 주의해 주세요.
참조의 경우는 최초의DOM 요소, 설정·개서의 경우는 모든DOM 요소가 대상이 됩니다.

html() / html("HTML 문자열")

DOM 요소를HTML 그리고 취득, 혹은 지정했다HTML 에 갈아넣습니다.

이 단락은 <p id="target_ref_dom_html"> 입니다.

alert(  $("#target_ref_dom_html").html()  );

$("#target_ref_dom_html").html("

단락의 내용을 고쳐 씁니다.");

val() / val( 치)

DOM 요소의 value 속성의 내용을 취득·설정합니다.

href() / href( 치) / id() / id( 치) / name() / name( 치)
/ rel() / rel( 치) / src() / src( 치) / title() / title( 치)

각각, 메소드명과 동명의 속성의 취득·설정을 실시합니다.

DOM(DOM 조작)

remove()

대상의DOM 요소를 삭제합니다.

이 단락은,<p id="target_ref_dom_remove"> 입니다.

	$("#target_ref_dom_remove").remove();

empty()

대상의DOM 요소의 아이 요소를 모두 삭제합니다.
DOM 요소 자체는 남습니다.
html() 그리고 내용을 대입할 때 등에, 일단 클리어 하고 싶은 경우에 이용할 수 있습니다.

이 단락은,<p id="target_ref_dom_empty"> 입니다.

$("#target_ref_dom_empty").empty();

append("HTML 문자열") / append(DOM 요소) / append([DOM 요소의] 배열)

대상의DOM 요소의 아이 요소의 말미에, 지정된 것을 추가합니다.

이 단락은,<p id="target_ref_dom_append"> 입니다.

$("#target_ref_dom_append").append("[[append]]");

prepend("HTML 문자열") / prepend(DOM 요소) / prepend([DOM 요소의] 배열)

대상의DOM 요소의 아이 요소의 선두에, 지정된 것을 추가합니다.

이 단락은,<p id="target_ref_dom_prepend"> 입니다.

$("#target_ref_dom_prepend").prepend("[[prepend]]");

appendTo("CSS/Xpath 문자열")

대상의DOM 요소를,CSS/XPath 지정으로 지정된 요소의 아이 요소의 말미로 이동합니다.

이 단락은,<p id="target_ref_dom_appendto"> 입니다.

이 단락은,<p id="target_ref_dom_appendto2"> 입니다.

$("#target_ref_dom_appendto").appendTo("#target_ref_dom_appendto2");

clone() (을)를 이용하는 것으로 카피할 수도 있습니다.

이 단락은,<p id="target_ref_dom_appendto_copy"> 입니다.

이 단락은,<p id="target_ref_dom_appendto_copy2"> 입니다.

$("#target_ref_dom_appendto_copy").clone()

    .appendTo("#target_ref_dom_appendto_copy2");

prependTo("CSS/Xpath 문자열")

대상의DOM 요소를,CSS/XPath 지정으로 지정된 요소의 아이 요소의 선두로 이동합니다.

이 단락은,<p id="target_ref_dom_prependto"> 입니다.

이 단락은,<p id="target_ref_dom_prependto2"> 입니다.

$("#target_ref_dom_prependto").prependTo("#target_ref_dom_prependto2");

clone() (을)를 이용하는 것으로 카피할 수도 있습니다.

이 단락은,<p id="target_ref_dom_prependto_copy"> 입니다.

이 단락은,<p id="target_ref_dom_prependto_copy2"> 입니다.

$("#target_ref_dom_prependto_copy").clone()

    .prependTo("#target_ref_dom_prependto_copy2");

before("HTML 문자열") / before(DOM 요소) / before([DOM 요소의] 배열)

대상의DOM 요소의 앞에, 지정된 것을 추가합니다.

이 단락은,<p id="target_ref_dom_before"> 입니다.

$("#target_ref_dom_before").before("[[before]]");

after("HTML 문자열") / after(DOM 요소) / after([DOM 요소의] 배열)

대상의DOM 요소의 뒤에, 지정된 것을 추가합니다.

이 단락은,<p id="target_ref_dom_after"> 입니다.

$("#target_ref_dom_after").after("[[after]]");

insertBefore("CSS/Xpath 문자열")

대상의DOM 요소를,CSS/XPath 지정으로 지정된 요소의 앞으로 이동합니다.

이 단락은,<p id="target_ref_dom_insertBefore1"> 입니다.

이 단락은,<p id="target_ref_dom_insertBefore2"> 입니다.

$("#target_ref_dom_insertBefore2").insertBefore("#target_ref_dom_insertBefore1");

clone() (을)를 이용하는 것으로 카피할 수도 있습니다.

이 단락은,<p id="target_ref_dom_insertBefore_copy"> 입니다.

이 단락은,<p id="target_ref_dom_insertBefore_copy2"> 입니다.

$("#target_ref_dom_insertBefore_copy").clone()

    .insertBefore("#target_ref_dom_insertBefore_copy2");

insertAfter("CSS/Xpath 문자열")

대상의DOM 요소를,CSS/XPath 지정으로 지정된 요소의 뒤로 이동합니다.

이 단락은,<p id="target_ref_dom_insertAfter"> 입니다.

이 단락은,<p id="target_ref_dom_insertAfter2"> 입니다.

$("#target_ref_dom_insertAfter").insertAfter("#target_ref_dom_insertAfter2");

clone() (을)를 이용하는 것으로 카피할 수도 있습니다.

이 단락은,<p id="target_ref_dom_insertAfter_copy"> 입니다.

이 단락은,<p id="target_ref_dom_insertAfter_copy2"> 입니다.

$("#target_ref_dom_insertAfter_copy").clone()

    .insertAfter("#target_ref_dom_insertAfter_copy2");

clone()

대상의DOM 요소를 복제합니다.
appendTo/prependTo/insertBefore/insertAfter 등의 메소드와 조합해 사용합니다.
샘플은 각각의 메소드를 참조해 주세요.

wrap(HTML) / wrap(DOM 요소)

대상의DOM 요소의 외측에, 지정했다HTML ·DOM 요소를 삽입합니다.

이 단락은,<p id="target_ref_dom_wrap"> 입니다.

$("#target_ref_dom_wrap").wrap("<p class='dotted'></p>");

remove("CSS/XPath 문자열")

지정한 요소만을remove() 하는 것이라고 생각합니다만, 사용법을 잘 모릅니다. . .

DOM(jQuery 오브젝트 조작)

jQuery 오브젝트가 가진다DOM 요소를 조작하는 메소드군입니다.
jQuery 오브젝트는DOM 요소의 집합을 스택으로 가지고 있어 많은 메소드는 호출해 때 상태를 스택에 보존한 다음, 조작을 실시합니다.
스택을1 개전의 단계에 되돌리려면 ,end() 메소드를 이용합니다.

end()

최신의 스택 상태를 파기해,1 개전 상태에 되돌립니다.

var $target = $("#target_ref_jquery_end");

var $p = $("p", $target);

jquery_dump($p); // 

모든 p 

태그가 돌려주어집니다.

$p.filter(".header"); // 

스택에 카피를 추가해,

                     // class="header" 

이외의 오브젝트를 삭제합니다.

jquery_dump($p);

$p.end();

jquery_dump($p); // 

최초 상태로 돌아오기 위해, 모든 p 

태그가 돌려주어집니다.

filter("CSS/XPath 지정 문자열") / filter(["CSS/XPath 지정 문자열" 의] 배열)

DOM 요소의 집합을, 지정했다CSS/XPath 지정으로 더욱 좁힙니다.
문자열의 배열로 지정했을 경우, 어느 쪽인가에 매치하는 것에 좁힙니다.
호출시 상태는 스택에 보존됩니다.

var $target = $("#target_ref_jquery_filter");

var $p = $("p", $target);

jquery_dump($p); // 

모든 p 

태그가 돌려주어집니다.

$p.filter(".header"); // 

스택에 카피를 추가해,

                     // class="header" 

이외의 오브젝트를 삭제합니다.

jquery_dump($p);

not("CSS/XPath 지정 문자열") / not(DOM 요소)

filter() 의 부정판입니다.
CSS/XPath 지정으로 지정된 것, 혹은 지정되었다DOM 요소를 없앱니다.
호출시 상태는 스택에 보존됩니다.

var $target = $("#target_ref_jquery_not");

var $p = $("p", $target);

jquery_dump($p); // 

모든 p 

태그가 돌려주어집니다.

$p.not(".header"); // 

스택에 카피를 추가해,

                     // class="header" 

(이)가 아닌 오브젝트를 삭제합니다.

jquery_dump($p);

find("CSS/XPath 지정 문자열")

DOM 요소의 집합에 포함되는 아이 요소로부터, 지정했다CSS/XPath 지정에 매치하는 것을 추출합니다.
호출시 상태는 스택에 보존됩니다.

var $target = $("#target_ref_jquery_find");

var $ul = $("ul", $target);

jquery_dump($ul);

jquery_dump($ul.find("li"));

next() / next("CSS/XPath 지정 문자열") / prev() / prev("CSS/XPath 지정 문자열")

next() (은)는,DOM 요소의 각각의 집합에 대해서, 그 요소의 다음에 있는 요소에 옮겨놓습니다. 다음의 요소가 없는 경우는, 그 요소는 삭제됩니다.
호출시 상태는 스택에 보존됩니다.
next("CSS/XPath 지정 문자열") 의 경우,next().filter("CSS/XPath 지정 문자열") (와)과 같은 동작이 됩니다. 다만, 스택은1 회 밖에 보존되지 않습니다.
prev() / prev("CSS/XPath 지정 문자열") 하 next() (와)과 달리, 그 요소의 전의 요소에 옮겨놓습니다.

var $target = $("#target_ref_jquery_next");

var $ulnext = $("ul", $target);

jquery_dump($ulnext);

$ulnext.next();

jquery_dump($ulnext);

$ulnext.end();

jquery_dump($ulnext);

var $target = $("#target_ref_jquery_next");

var $pnext = $("p", $target);

jquery_dump($pnext);

$pnext.next();

jquery_dump($pnext);

var $target = $("#target_ref_jquery_next");

var $ulnext = $("ul", $target);

jquery_dump($ulnext);

$ulnext.next(".nextfilter");

jquery_dump($ulnext);

$ulnext.end();

jquery_dump($ulnext); // 1

개전의 스택은,next(".nextfilter") 

의 실행전의 내용입니다.

var $target = $("#target_ref_jquery_next");

var $pprev = $("p", $target);

jquery_dump($pprev);

$pprev.prev();

jquery_dump($pprev);

children() / children("CSS/XPath 지정 문자열")

DOM 요소의 각각 붙고, 아이 요소를 돌려줍니다.
호출시 상태는 스택에 보존됩니다.
children("CSS/XPath 지정 문자열") 의 경우,children().filter("CSS/XPath 지정 문자열") (와)과 같은 동작이 됩니다. 다만, 스택은1 회 밖에 보존되지 않습니다.

var $target = $("#target_ref_jquery_children");

var $children = $("ul", $target);

jquery_dump($children);

$children.children();

jquery_dump($children);

$children.children();

jquery_dump($children);

var $target = $("#target_ref_jquery_children");

var $children = $("ul", $target);

jquery_dump($children);

$children.children(".top");

jquery_dump($children);

parent() / parent("CSS/XPath 지정 문자열")

각각DOM 요소의 친요소를 돌려줍니다. 다만, 공통의 부모를 가지는 요소가 다수 있었을 경우, 부모는 1개만 돌려주어집니다.
호출시 상태는 스택에 보존됩니다.
parent("CSS/XPath 지정 문자열") 의 경우,parent().filter("CSS/XPath 지정 문자열") (와)과 같은 동작이 됩니다. 다만, 스택은1 회 밖에 보존되지 않습니다.

var $target = $("#target_ref_jquery_parent");

var $parent = $("#target_ref_jquery_parent_2", $target);

jquery_dump($parent);

$parent.parent();

jquery_dump($parent);

$parent.parent();

jquery_dump($parent);

var $target = $("#target_ref_jquery_parent");

var $parent = $("li", $target);

jquery_dump($parent);

$parent.parent();

jquery_dump($parent);

$parent.parent();

jquery_dump($parent);

var $target = $("#target_ref_jquery_parent");

var $parent = $("li", $target);

jquery_dump($parent);

$parent.parent(".top");

jquery_dump($parent);

parents() / parents("CSS/XPath 지정 문자열")

각각DOM 요소의 친요소, 그 친요소, 그 친요소···(와)과 순서에 돌려줍니다. 다만, 루트의 요소는 포함되지 않습니다.
호출시 상태는 스택에 보존됩니다.
parents("CSS/XPath 지정 문자열") 의 경우,parents().filter("CSS/XPath 지정 문자열") (와)과 같은 동작이 됩니다. 다만, 스택은1 회 밖에 보존되지 않습니다.

// 

이 샘플은 처리가 무겁습니다.

// 

다이얼로그가 화면을 초과했을 경우,Enter

키로 닫아 주세요.

var $target = $("#target_ref_jquery_parents");

var $parents = $("#target_ref_jquery_parents_2", $target);

jquery_dump($parents);

$parents.parents();

jquery_dump($parents);

var $target = $("#target_ref_jquery_parents");

var $parents = $("li", $target);

jquery_dump($parents);

$parents.parents(".top");

jquery_dump($parents);

ancestors() / ancestors("CSS/XPath 지정 문자열")

parents() 메소드의 별명입니다. 자세한 것은 parents 메소드를 참조해 주세요.

siblings() / siblings("CSS/XPath 지정 문자열")

각각DOM 요소의 형제 요소를 돌려줍니다. 다만, 공통의 형제 요소가 다수 있었을 경우, 독특한 1개만이 돌려주어집니다.
호출시 상태는 스택에 보존됩니다.
siblings("CSS/XPath 지정 문자열") 의 경우,siblings().filter("CSS/XPath 지정 문자열") (와)과 같은 동작이 됩니다. 다만, 스택은1 회 밖에 보존되지 않습니다.

var $target = $("#target_ref_jquery_siblings");

var $siblings = $("li.top", $target);

jquery_dump($siblings);

$siblings.siblings();

jquery_dump($siblings);

var $target = $("#target_ref_jquery_siblings");

var $siblings = $("ul", $target);

jquery_dump($siblings);

$siblings.siblings();

jquery_dump($siblings);

var $target = $("#target_ref_jquery_siblings");

var $siblings = $("ul", $target);

jquery_dump($siblings);

$siblings.siblings(".top");

jquery_dump($siblings);

contains( 문자열)

DOM 요소의 집합을, 지정한 문자열을 텍스트로 가지는 요소에 좁힙니다.
호출시 상태는 스택에 보존됩니다.

var $target = $("#target_ref_jquery_contains");

var $contains = $("li", $target);

jquery_dump($contains);

$contains.contains("1-");

jquery_dump($contains);

add("CSS/XPath 지정 문자열") / add(DOM 요소) / add([DOM 요소의] 배열)

DOM 요소의 집합에,CSS/XPath 지정 문자열로 매치한 요소, 혹은 지정했다DOM 요소를 더합니다.
CSS/XPath 지정 문자열을 지정하는 경우, 대상은 문서 전체가 되어,$("CSS/XPath 지정 문자열", context) 의 같은 형식에서 범위를 지정할 수 없습니다.
호출시 상태는 스택에 보존됩니다.

var $target = $("#target_ref_jquery_add");

var $add = $("ul", $target);

jquery_dump($add);

$add.add("#target_ref_jquery_add2");

jquery_dump($add);

var $target = $("#target_ref_jquery_add");

var $add = $("ul", $target);

jquery_dump($add);

$add.add($("p", $target)[0]); // DOM

요소를 추가합니다

jquery_dump($add);

CSS

css( 키) / css( 키, 치) / css( 해시)

CSS 의 속성을 조작합니다.
키만을 지정했을 경우는 취득, 키, 값으로의 지정이나, 해시로 지정했을 경우는, 그러한 설정치로 덧쓰기합니다.
취득의 경우는, 최초의DOM 요소가 대상이 됩니다. 값을 설정하는 경우는, 모든DOM 요소가 대상이 됩니다.

background() / background( 치) / color() / color( 치)
/ float() / float( 치) / overflow() / overflow( 치)
/ position() / position( 치)

각각, 메소드명과 동명의CSS 속성의 취득·설정을 실시합니다.

left() / left( 치) / top() / top( 치)

각각, 메소드명과 동명의CSS 속성의 취득·설정을 실시합니다.

height() / height( 치) / width() / width( 치)

각각, 메소드명과 동명의CSS 속성의 취득·설정을 실시합니다.

효과

hide() / show()

show() (은)는 지정된 요소를 비표시 상태로부터 표시 상태로 변경합니다. 벌써 표시 상태이면 아무것도 하지 않습니다.
hide() (은)는 지정된 요소를 표시 상태로부터 비표시 상태로 변경합니다. 벌써 비표시 상태이면 아무것도 하지 않습니다.

이 단락은<p id="target_ref_effect_show"> 입니다.

$("#target_ref_effect_show").show();

$("#target_ref_effect_show").hide();

toggle()

지정된 요소의 표시·비표시를 바꿉니다.

이 단락은<p id="target_ref_effect_toggle"> 입니다.

$("#target_ref_effect_toggle").toggle();

기본 효과 (Basic Animations)

[Configure Your Download] 했을 경우,[Basic Animations] (을)를 선택하고 있지 않으면 이하의 함수는 이용할 수 없습니다.

show( 속도) / show( 속도, 콜백 함수)
/ hide( 속도) / hide( 속도, 콜백 함수)

show() / hide() (은)는 요소의 사이즈를 변경하면서, 표시한다, 혹은 비표시로 합니다.
표시중의 요소에 show() (을)를 사용하거나 그 역을 실시하면, 불필요한 애니메이션이 실행되는 일이 있습니다. 이것을 막기 위해서는, 요소의 지정에 :hidden ,:visible (을)를 이용해 주세요.
속도는,"fast", "normal", "slow" 의 어느쪽이든을 지정하는지,ms(1/1000 초) 단위의 수치로 지정합니다.
제2 인수에 콜백 함수를 지정하면, 애니메이션이 완료했을 때에 콜백 함수가 불려 갑니다.

이 단락은<p id="target_ref_effect_show_speed"> 입니다.

$("#target_ref_effect_show_speed").show(2000);

$("#target_ref_effect_show_speed").hide("slow");

$("#target_ref_effect_show_speed:hidden").show("normal");

$("#target_ref_effect_show_speed:visible").hide("slow",

    function(){

        alert(  "animation done."  );

    });

slideDown( 속도) / slideDown( 속도, 콜백 함수)
/ slideUp( 속도) / slideUp( 속도, 콜백 함수)
/ slideToggle( 속도) / slideToggle( 속도, 콜백 함수)

slideDown() / slideUp() (은)는 요소를 슬라이드시키면서, 표시한다, 혹은 비표시로 합니다.slideToggle() (은)는, 표시·비표시를 바꿉니다.
표시중의 요소에 slideDown() (을)를 사용하거나 그 역을 실시하면, 불필요한 애니메이션이 실행되는 일이 있습니다. 이것을 막기 위해서는, 요소의 지정에 :hidden ,:visible (을)를 이용해 주세요.
속도는,"fast", "normal", "slow" 의 어느쪽이든을 지정하는지,ms(1/1000 초) 단위의 수치로 지정합니다.
제2 인수에 콜백 함수를 지정하면, 애니메이션이 완료했을 때에 콜백 함수가 불려 갑니다.

이 단락은<p id="target_ref_effect_slide"> 입니다.

$("#target_ref_effect_slide").slideDown(2000);

$("#target_ref_effect_slide").slideUp("slow");

$("#target_ref_effect_slide:hidden").slideDown("normal");

$("#target_ref_effect_slide:visible").slideUp("slow",

    function(){

        alert(  "animation done."  );

    });

$("#target_ref_effect_slide").slideToggle("normal");

fadeIn( 속도) / fadeIn( 속도, 콜백 함수)
/ fadeOut( 속도) / fadeOut( 속도, 콜백 함수)
/ fadeTo( 속도, 투명도) / fadeTo( 속도, 투명도, 콜백 함수)

fadeIn() / fadeOut() (은)는 요소를 페이드시켜, 표시한다, 혹은 비표시로 합니다. fadeTo() (은)는 지정된 투명도까지 애니메이션 시킵니다.
대상이 되는 오브젝트는, 폭·높이가 벌써 결정하지 않으면 안됩니다.
표시중의 요소에 fadeIn() (을)를 사용하거나 그 역을 실시하면, 불필요한 애니메이션이 실행되는 일이 있습니다. 이것을 막기 위해서는, 요소의 지정에 :hidden ,:visible (을)를 이용해 주세요.
속도는,"fast", "normal", "slow" 의 어느쪽이든을 지정하는지,ms(1/1000 초) 단위의 수치로 지정합니다.
제2 인수 또는 제3 인수에 콜백 함수를 지정하면, 애니메이션이 완료했을 때에 콜백 함수가 불려 갑니다.

이 단락은<p id="target_ref_effect_fade"> 입니다.

$("#target_ref_effect_fade").fadeIn(2000);

$("#target_ref_effect_fade").fadeOut("slow");

$("#target_ref_effect_fade:hidden").fadeIn("normal");

$("#target_ref_effect_fade:visible").fadeOut("slow",

    function(){

        alert(  "animation done."  );

    });

$("#target_ref_effect_fade").fadeTo("slow", 0.5);

$("#target_ref_effect_fade").fadeTo("slow", 0.1);

animate( 파라미터, 속도, 콜백 함수)

높이, 투명도등의 파라미터를 지정하고, 애니메이션을 시키는 메소드입니다.
파라미터에는,"height", "top", "opacity" 등을, 어떻게 변화시킬까 "show", "hide", 수치로 지정합니다. 숫자의 지정은 left/top 등에 대해 잘 움직이지 않는 것이 있는 것 같습니다.
속도는,"fast", "normal", "slow" 의 어느쪽이든을 지정하는지,ms(1/1000 초) 단위의 수치로 지정합니다.
제3 인수에 콜백 함수를 지정하면, 애니메이션이 완료했을 때에 콜백 함수가 불려 갑니다.

이 단락은<p id="target_ref_effect_animate"> 입니다.

// 1

회라도show/hide

(을)를 실시하면,CSS

의 설정에 overflow: hidden 

(이)가 더해져 동작이 변화합니다.

// overflow:hidden 

하지만 없는 경우(최초 상태)에서는, 폭이 좁아지면 개행을 해 높이가 바뀝니다.

// overflow:hidden 

하지만 있는 경우(show/hide

후 )에서는, 폭이 좁아지면, 표시할 수 없는 부분은 숨습니다.

// width

변경으로 높이를 바꾸고 싶지 않은 경우는,CSS

정의에 주의해 주세요.

$("#target_ref_effect_animate").animate({

    width: 100

}, "slow");

$("#target_ref_effect_animate").animate({

    width: 500

}, "slow");

$("#target_ref_effect_animate").animate({

    opacity: 'show',

    height: 'show'

}, "slow");

$("#target_ref_effect_animate").animate({

    opacity: 'hide',

    height: 'hide'

}, "slow");

확장 이벤트 (Advanced Events)

[Configure Your Download] 했을 경우,[Advanced Events] (을)를 선택하고 있지 않으면 이하의 함수는 이용할 수 없습니다.

event( 함수)
/ unevent( 함수) / unevent()
oneevent( 함수)

이벤트의 설정을 실시합니다. HTML (으)로의 onclick / onfocus 등과 같은 일을,JavaScript 옆으로부터 설정할 수 있습니다.
이탤릭의event 에, 설정하고 싶은 이벤트명을 기술합니다. 기술할 수 있는 이벤트는 이하와 같습니다.

blur,focus,load,resize,scroll,unload,click,dblclick, mousedown,mouseup,mousemove,mouseover,mouseout,change,reset,select, submit,keydown,keypress,keyup,error

event() 그리고 이벤트에 함수를 묶습니다.
unevent() 그리고, 이벤트가 묶어를 해제합니다.함수를 지정하지 않으면, 모든 묶어가 해제됩니다.
oneevent() (은)는, 이벤트에 함수를 묶습니다만, 한 번 이벤트가 발생하면 묶어가 해제됩니다.
여러 차례 묶으면, 그 회수만 함수가 실행되는 것에 주의해 주세요.

이 단락은<p id="target_ref_event"> 입니다.

$("#target_ref_event").click(function(){

    alert(  "clicked!"  );

});

// 

이 샘플을 실행 후, 위의 점선의 단락을 클릭해 보세요.

$("#target_ref_event").unclick();

$("#target_ref_event").oneclick(function(){

    alert(  "clicked!"  );

});

// 

이 샘플을 실행 후, 위의 점선의 단락을 클릭해 보세요.

// 

최초의1

회만alert

하지만 팝업 합니다.

ready( 함수)

$(document).ready( 함수) 의 형태로 이용해, 문서가 로드 되었을 때에 초기화 처리를 실행합니다.
이 긴 문자열 대신에, 짧고 $( 함수) (이)라고 쓸 수 있기 때문에, 이쪽을 이용하는 것을 추천합니다.

$(function(){

    // HTML

로드 후에 실행하고 싶은 초기화 코드

});

$(document).ready(function(){

    // HTML

로드 후에 실행하고 싶은 초기화 코드

});

hover(over 함수,out 함수)

마우스 오버 처리를 행하기 위한 이벤트를 설정합니다.
마우스가 대상 오브젝트에 들어갔을 때에 over 함수 하지만 불려 가 나왔을 때에 out 함수 하지만 불려 갑니다.

이 단락은<p id="target_ref_event_hover"> 입니다.

$("#target_ref_event_hover").hover(function(){

    // 

대상 오브젝트에 들어갔다

    $(this).addClass("background_red");

}, function(){

    // 

대상 오브젝트로부터 빠졌다

    $(this).removeClass("background_red");

});

// 

이 샘플을 실행 후, 위의 점선의 단락에 마우스 커서를 이동해 보세요.

toggle( 함수1, 함수2)

대상 오브젝트가 클릭될 때마다, 함수1 , 함수2 (을)를 교대로 호출합니다.

이 단락은<p id="target_ref_event_toggle"> 입니다.

$("#target_ref_event_toggle").toggle(function(){

    // (0

(으)로부터 세어)

짝수 번째의 클릭

    $(this).addClass("background_red");

}, function(){

    //(0

(으)로부터 세어)

홀수 번째의 클릭

    $(this).removeClass("background_red");

});

// 

이 샘플을 실행 후, 위의 점선의 단락을 클릭해 보세요.

Ajax (Basic AJAX)

[Configure Your Download] 했을 경우,[Basic AJAX] (을)를 선택하고 있지 않으면 이하의 함수는 이용할 수 없습니다.
여러가지 메소드를 이용했다Ajax 메소드 테스트 페이지 도 참조해 주세요.

load(url,params,callback)

Ajax 그리고 리모트의 파일을 읽어들여, 옮겨놓습니다.
callback 함수를 지정했을 경우, 제1 인수에 리모트의 파일 내용, 제2 인수에 스테이터스가 돌아갑니다. 스테이터스는,"success" 인가 "error" 의 어느 쪽인지입니다.
params (을)를 지정했을 경우는POST 메소드, 지정하지 않는 경우는GET 메소드가 됩니다.

이 단락은,<p id="target_ref_ajax_load"> 입니다.

$("#target_ref_ajax_load").load("hello.html");

$("#target_ref_ajax_load").load("hello.html", function(html, status){

    alert(  "html: " + html + "nstatus: " + status  );

});

$("#target_ref_ajax_load").load("notfound.html", function(html, status){

    alert(  "html: " + html + "nstatus: " + status  );

});

Ajax 메소드 테스트 페이지 도 참조해 주세요.

loadIfModified(url,params,callback)

load (와)과 같은 동작을 합니다만, 같다URL 에 대해서 여러 차례 loadIfModified() 했을 경우에, 2 번째 이후에 If-Modified-Since 헤더 첨부로 리퀘스트를 실시합니다. 만약 리모트의 파일이 갱신되어 있지 않은 경우,DOM 요소의 치환 하행 깨지지 않습니다.
리모트의 파일의 갱신을 정기적으로 체크하는 경우에 이용할 수 있습니다.
callback 함수를 지정했을 경우, 제1 인수에 리모트의 파일 내용, 제2 인수에 스테이터스가 돌아갑니다. 스테이터스는,"success" 인가 "notmodified" 인가 "error" 의 머지않아인가입니다.
params (을)를 지정했을 경우는POST 메소드, 지정하지 않는 경우는GET 메소드가 됩니다.

Ajax 메소드 테스트 페이지 도 참조해 주세요.

$.get(url,params,callback)

Ajax 그리고 리모트의 파일을GET 메소드로 읽어들여, 파일 내용을 돌려줍니다.
인수의 지정 방법은 $.load() (와)과 같습니다.

Ajax 메소드 테스트 페이지 도 참조해 주세요.

$.getIfModified(url,params,callback)

Ajax 그리고 리모트의 파일을GET 메소드로 읽어들여, 파일 내용을 돌려줍니다.
인수의 지정 방법은 $.loadIfModified() (와)과 같습니다.

Ajax 메소드 테스트 페이지 도 참조해 주세요.

$.post(url,params,callback)

Ajax 그리고 리모트의 파일을POST 메소드로 읽어들여, 파일 내용을 돌려줍니다.
인수의 지정 방법은 $.load() (와)과 같습니다.

Ajax 메소드 테스트 페이지 도 참조해 주세요.

$.ajaxTimeout(Timeout)

Ajax 계의 함수·메소드의 타임 아웃을ms 단위(1/1000 초)로 지정합니다. 0 (을)를 지정했을 경우는, 타임 아웃 처리를 실시하지 않습니다. 디폴트에서는0 하지만 설정되어 있습니다.
타임 아웃 시간 기다려도 리퀘스트가 완료하지 않는 경우,error 취급이 됩니다.
hello_timeout.cgi 하5 초간 응답을 돌려주지 않는다CGI 입니다. 브라우저의 캐쉬를 막기 위해서, 파라미터를 추가하고 있습니다.

이 단락은 <p id="target_ref_ajax_load_timeout"> 입니다.

$.ajaxTimeout(2000); // 

단위는ms

$("#target_ref_ajax_load_timeout").load("hello_timeout.cgi", {

    timekey: 1

    }, function(text, status) {

    alert(  "text: " + text + "nstatus: " + status  );

});

$.ajaxTimeout(0); // 0

지정으로 타임 아웃 없음이 됩니다

$("#target_ref_ajax_load_timeout").load("hello_timeout.cgi", {

    timekey: 1

    }, function(text, status) {

    alert(  "text: " + text + "nstatus: " + status  );

});

Ajax 메소드 테스트 페이지 도 참조해 주세요.

ajaxStart( 콜백 함수) / ajaxStop( 콜백 함수)
/ ajaxComplete( 콜백 함수) / ajaxError( 콜백 함수) / ajaxSuccess( 콜백 함수)

Ajax 호출해에 관한 글로벌인 콜백 함수를 설정합니다.
읽기중에 애니메이션을 표시시키는, 등의 목적으로 이용할 수 있습니다.
Ajax 리퀘스트가 실행중이 되었을 때에 ajaxStart 의 콜백이 불려 가 모든 리퀘스트의 실행이 완료했을 때에 ajaxStop 의 콜백이 불려 갑니다.
동시에 복수의 리퀘스트가 실행되었을 경우,ajaxStart/ajaxStop (은)는 최초와 마지막에1 회씩 불려 갑니다.
ajaxComplete / ajaxError / ajaxSuccess (은)는,Ajax 리퀘스트가 완료·실패·성공했을 때에, 리퀘스트마다 불려 갑니다.
1 회의 리퀘스트로,ajaxComplete 하지만1 회와ajaxError/ajaxSuccess 의 어느 쪽인지가1 회 불려 갑니다.

$("#loading").ajaxStart(function(){

    $(this).show();

});

$("#loading").ajaxStop(function(){

    $(this).hide();

});

Ajax 메소드 테스트 페이지 도 참조해 주세요.
ajaxStart/ajaxStop 그리고 화면상부에 애니메이션을 표시하고 있습니다.

유틸리티 함수

유틸리티 함수군입니다.$.method 그렇다고 하는 형식에서 이용할 수 있게 되어 있습니다.

$.each( 오브젝트/ 배열, 함수)

오브젝트 또는 배열의 모든 요소에 대해서, 지정한 함수를 호출합니다.
배열에 대해서 실행했을 경우, 함수의 제1 인수에 배열의 첨자(0 시작)이,this 에 요소가 건네받습니다.
오브젝트에 대해서 실행했을 경우, 함수의 제1 인수에 키가,this 에 값이 건네받습니다.

// 

배열의 경우

$.each(["

있어","

","

하"], function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

// 

오브젝트의 경우

$.each({ key1: "value1", key2: "value2" }, function(i){

    alert(  "

인수: " + i + "n

치: " + this  );

});

$.extend( 오브젝트1, 오브젝트2)

오브젝트1 에 오브젝트2 의 내용을 더합니다.
계승을 실시할 때에 이용할 수 있습니다.

var settings = { key1: 1, key2: 2 };

var add = { key2: "

아", key3 : "

있어" };

$.extend(settings, add);

$.each(settings, function(i) {

    alert(  "

인수: " + i + "n

치: " + this  );

});

$.grep( 배열, 함수, 반전 플래그)

배열의 각 요소에 대해서 함수를 실행해, 그 결과에 의해서 배열로부터 요소를 꺼냅니다. 원래의 배열은 변경되지 않습니다.
반전 플래그가false 의 경우는, 함수의 실행 결과가 true 의 요소를 꺼냅니다. 반전 플래그가true 의 경우, 그 거꾸로 됩니다. 생략 했을 경우, 반전 플래그는 false (으)로서 다루어집니다.

var data = [1,2,3,4];

var data2 = $.grep(data, function(i){

    return (i % 2 == 0);

});

$.each(data2, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

var data = [1,2,3,4];

var data2 = $.grep(data, function(i){

    return (i % 2 == 0);

}, true);

$.each(data2, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

$.map( 배열, 함수)

배열의 각 요소에 대해서 함수를 실행해, 그 함수의 반환값의 배열을 돌려줍니다. 원래의 배열은 변경되지 않습니다.
함수가 값을 돌려주면 그 값이 그대로 반환값에 포함됩니다. 함수가undefined (을)를 돌려주었을 경우는 반환값에는 포함되지 않습니다. 함수가 배열을 돌려주었을 경우는, 배열 오브젝트가 아니고, 각각의 값이 반환값의 배열에 추가됩니다.

var data = [1,2,3];

var data2 = $.map(data, function(i){

    return i * 10;

});

$.each(data2, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

var data = [1,2,3];

var data2 = $.map(data, function(i){

	if(i == 2) {

		return undefined;

	}

	return i * 10;

});

$.each(data2, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

var data = [1,2];

var data2 = $.map(data, function(i){

	return [i*10, i*100];

});

$.each(data2, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

$.merge( 배열1, 배열2)

지정되었다2 개의 배열을 머지 합니다만, 중복은 없앱니다. 원래의 배열은 양쪽 모두 변경되지 않습니다.
중복이 있는 경우, 우선 배열1 의 내용이 모두 돌려주어진 후, 배열2 중 배열1 (와)과 중복되지 않은 것이 돌려주어집니다. 배열1 중(안)에서 중복 하고 있는 요소나, 배열2 중(안)에서 중복 하고 있는 요소는, 존재하는 개수분 돌려주어집니다.

var data1 = [1,2];

var data2 = [3,4];

var mergedata = $.merge(data1, data2);

$.each(mergedata, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

var data1 = [1,2,1];

var data2 = [4,2,3,1,3];

var mergedata = $.merge(data1, data2);

$.each(mergedata, function(i){

    alert(  "

배열[" + i + "] = " + this  );

});

$.trim( 문자열)

문자열의 전후에 있는 공백을 없앤 문자열을 돌려줍니다.

var str = "  

안녕하세요  ";

alert(  "[" + str + "]"  );

str = $.trim(str);

alert(  "[" + str + "]"  );

// 

탭이나 개행도 공백으로 간주해집니다

var str = "t

안녕하세요n";

alert(  "[" + str + "]"  );

str = $.trim(str);

alert(  "[" + str + "]"  );

// 

전각 공백도 없앨 수 있습니다

var str = "

　안녕하세요　";

alert(  "[" + str + "]"  );

str = $.trim(str);

alert(  "[" + str + "]"  );

크로스 브라우저 함수

크로스 브라우저를 위한 함수군입니다. 아마 가까운 시일내에 코어에 추가된다고 생각합니다만, 현단계에서는 사용할 수 없습니다.

height()

오브젝트의 높이를 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 CSS 의 높이를 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 높이(innerHeight ), $(window) 에 대해서 사용하면, 표시 영역의 높이를 돌려줍니다.

이 단락은 <p id="target_ref_cross_height"> 입니다.

alert(  $("#target_ref_cross_height").height()  );

alert(  $(document).height()  );

alert(  $(window).height()  );

width()

오브젝트의 폭을 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 CSS 의 폭을 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 폭(innerWidth ), $(window) 에 대해서 사용하면, 표시 영역의 폭을 돌려줍니다.

이 단락은 <p id="target_ref_cross_width"> 입니다.

alert(  $("#target_ref_cross_width").width()  );

alert(  $(document).width()  );

alert(  $(window).width()  );

innerHeight()

오브젝트의 높이를 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 보더를 포함하지 않는 높이를 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 높이(innerHeight ), $(window) 에 대해서 사용하면, 표시 영역의 높이를 돌려줍니다.

이 단락은 <p id="target_ref_cross_innerheight"> 입니다.

alert(  $("#target_ref_cross_innerheight").innerHeight()  );

alert(  $(document).innerHeight()  );

alert(  $(window).innerHeight()  );

innerWidth()

오브젝트의 높이를 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 보더를 포함하지 않는 폭을 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 폭(innerWidth ), $(window) 에 대해서 사용하면, 표시 영역의 폭을 돌려줍니다.

이 단락은 <p id="target_ref_cross_innerwidth"> 입니다.

alert(  $("#target_ref_cross_innerwidth").innerwidth()  );

alert(  $(document).innerwidth()  );

alert(  $(window).innerwidth()  );

outerHeight()

오브젝트의 높이를 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 보더를 포함한 높이를 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 높이(outerHeight ), $(window) 에 대해서 사용하면, 표시 영역의 높이를 돌려줍니다.

이 단락은 <p id="target_ref_cross_outerheight"> 입니다.

alert(  $("#target_ref_cross_outerheight").outerHeight()  );

alert(  $(document).outerHeight()  );

alert(  $(window).outerHeight()  );

outerWidth()

오브젝트의 높이를 취득합니다.
임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 보더를 포함한 폭을 돌려줍니다. $(document) 에 대해서 사용하면, 문서의 폭(outerWidth ), $(window) 에 대해서 사용하면, 표시 영역의 폭을 돌려줍니다.

이 단락은 <p id="target_ref_cross_outerwidth"> 입니다.

alert(  $("#target_ref_cross_outerwidth").outerwidth()  );

alert(  $(document).outerwidth()  );

alert(  $(window).outerwidth()  );

scrollLeft() / scrollTop()

오른쪽 또는 아래에 스크롤 된 양을 취득합니다.
overflow:auto 의 요소를 가지는 임의의jQuery 오브젝트,$(document) ,$(window) 에 대해서 이용할 수 있습니다. jQuery 오브젝트에 대해서 사용하면, 최초의 요소의 스크롤 위치를 돌려줍니다.다만, 요소는 overflow:auto 일 필요가 있습니다. $(document) 에 대해서 사용하면, 문서에 대한 스크롤 위치,$(window) 에 대해서 사용하면, 표시 영역에 대한 스크롤 위치를 돌려줍니다.

이 단락은 <p id="target_ref_cross_scroll"> 입니다.

alert(  $("#target_ref_cross_scroll").scrollLeft()  );

alert(  $("#target_ref_cross_scroll").scrollTop()  );

alert(  $(document).scrollLeft()  );

alert(  $(document).scrollTop()  );

alert(  $(window).scrollLeft()  );

alert(  $(window).scrollTop()  );

Open-Source 기반의 Javascript Library중 하나인 jQuery를 Microsoft에서 적용하기로 했습니다.(많이 늦은 내용.. 찾아보니 처음 기사를 본게.. 9월30일입니다.) 자세한 내용은 본사의 부사장으로 계신 우리의 Scott님의 블로그를 http://weblogs.asp.net/scottgu/archive/2008/09/28/jquery-and-microsoft.aspx 를 참고 하시길 바랍니다.

가볍고 크로스브라우져에 강하다는 문구가 많은 설득력을 가지고 있어 보입니다.

Downloading jQuery

svn co http://jqueryjs.googlecode.com/svn/trunk

svn co http://jqueryjs.googlecode.com/svn/tags/<version>
e.g. svn co http://jqueryjs.googlecode.com/svn/tags/1.0.4

svn co http://jquery-ui.googlecode.com/svn/tags

■ 환경 설정

개발 환경 설정에는 다음과 같이 3가지 방법이 있다.

1. JSDK 1.3이하 버젼 & JCE 1.2.1 글로벌 버전 JCE 1.2.1 버전은 http://java.sun.com 사이트에서 회원가입을 해야지 Down 받을수 있다. JCE는 미국에서 무기로 관주 되기 때문에 글로벌 버전은 미국, 케나다 버전과 다르다.

2. JSDK 1.4에는 Java Cryptography Extension 1.2.1 버전이 포함되어 있다.

3. 다운 받은 JCE의 압축을 풀고 lib방 밑에 있는 모든 jar파일을[JavaHome]jrelibext방으로 카피한다. 그리고 JCE 알고리즘을 사용하기 위해서 SunJCE 프로바이터를 설치 해야 한다.

설치하기 위해서는 [JavaHome]jrelibsecurityjava.security 파일에 다음을 추가한다.

security.provider.1=sun.security.provider.Sun,

security.provider.2=com.sun.crypto.provider.SunJCE

■ 서로 다른 개념들

1. 보안 != 암호 : 애플리케이션에 암호를 추가하는 것이 애플리케이션을 안전하게 하지 못한다.

2. 올바른 보안 모델 != 버그가 없는 구현 : 훌륭한 보안 모델이라고 해도 구현 과정에서의 버그는 공겨자의 대상이 될 수 있다.

3. 테스트 != 공식적인 증명

4. 컴포넌트 보안 != 전반적인 시스템 보안

5. 자바 보안 != 애플릿 통제

Base 64

Base64는 바이트 배열을 아스키 문자로 표현하기 위한 시스템이다. Base64체계는 RFC1521의 Section5.2에 완전하게 기술되어 있다. sun.misc.BASE64Encoder는 바이트 배열을 가지고 base64 disit를 가지 문자열을 생성한다. 이에 대응하는 클래스 BASE64Decoder는 문자열을 가지고 원래 바이트 배열을 생성한다.

Sun에서는 Base64를 지원할 의무가 없다.

■ 예제 프로그램

//-- Masher 메시지 축약

package test.crypto.part1;

import java.security.*;

import java.io.*;

import sun.misc.*;

public class Masher {

public Masher() {

}

private void exec(String targetFileName) {

try {

// MD5알고리즘을 이용한 메시지 축약 객체를 생성한다.

MessageDigest md = MessageDigest.getInstance("MD5");

FileInputStream fin = new FileInputStream(targetFileName);

byte[] buffer = new byte[8192];

int length;

while ( (length = fin.read(buffer)) != -1 ) {

md.update(buffer,0,length);

}

byte[] raw = md.digest();

// 출력 가능한 문자열로 변환한다.

BASE64Encoder encoder = new BASE64Encoder();

String base64 = encoder.encode(raw);

System.out.println(base64);

} catch(NoSuchAlgorithmException nalgoe) {

System.err.println(nalgoe);

} catch(FileNotFoundException fnote) {

System.err.println(fnote);

} catch(IOException ioe) {

System.err.println(ioe);

}

}

public static void main(String[] args) {

if(args.length < 1) {

System.out.println("메시지 축약의 대상 파일을 선택하여 주십시요");

System.exit(0);

}

String targetFileName = args[0];

Masher masher = new Masher();

masher.exec(targetFileName);

}

}

매시지 축약은 데이터를 증명하지만, 메시지에 대해서는 전혀 알 수 없다.

// DES알고리즘을 이용한 대칭키 암복호화

package test.crypto.part1;

import javax.crypto.*;

import java.io.*;

import java.security.*;

import sun.misc.*;

public class SecretWriting {

public SecretWriting() {

}

public void exec(String args[]) throws Exception{

// key를 얻어 생성한다.

Key key;

try{

ObjectInputStream in = new ObjectInputStream(new FileInputStream("SecretKey.ser"));

key = (Key)in.readObject();

in.close();

} catch (FileNotFoundException fnote) {

// ser Key 파일이 없으면 실행된다.

// DES 대칭키 알고리즘을 정의해서 키 제너레이터를 생성한다.

KeyGenerator keygenerator = KeyGenerator.getInstance("DES");

// 랜덤 함수로 초기화한다.

keygenerator.init(new SecureRandom());

// 키를 생성한다.

key = keygenerator.generateKey();

// 생성된 키 객체를 바이널리 파일로 저장한다.

ObjectOutputStream out = new ObjectOutputStream(new FileOutputStream("SecretKey.ser"));

out.writeObject(key);

out.close();

}

Cipher cipher = Cipher.getInstance("DES/ECB/PKCS5Padding");

// -e문자열이 없으면 복호화 한다. 다음은 암호화 한다.

if(args[0].indexOf("e") != -1) {

cipher.init(Cipher.ENCRYPT_MODE,key);

String amalgam = args[1];

for(int i = 2; i < args.length; i++) {

amalgam += " "+args[i];

}

byte[] stringBytes = amalgam.getBytes("UTF8");

byte[] raw = cipher.doFinal(stringBytes);

BASE64Encoder encoder = new BASE64Encoder();

String base64 = encoder.encode(raw);

System.out.println(base64);

} else if(args[0].indexOf("d") != -1) {

cipher.init(Cipher.DECRYPT_MODE,key);

BASE64Decoder decoder = new BASE64Decoder();

byte[] raw = decoder.decodeBuffer(args[1]);

byte[] stringBytes = cipher.doFinal(raw);

String result = new String(stringBytes, "UTF8");

System.out.println(result);

}

}

public static void main(String[] args) throws Exception{

if(args.length < 2) {

System.out.println("사용예 java tesst.crypto.part1.SecretWriting -[e|d] STRING1 STRING2 ...");

System.exit(0);

}

SecretWriting secretWriting = new SecretWriting();

secretWriting.exec(args);

}

}

DES 알고리즘은 동일한 키를 생성하여 암호화와 복호화가 이루워지는 대칭키 방식이다.

Chapter 2 기본기

■ 보안의 3대 규칙

1. 기밀성(Confidentially) : 비인가 된 사람은 내용을 볼 수 없어야 한다.

① 대칭암호화 : 송신측과 수신측이 동일한 키를 사용한다.(비밀키, 개인키 방식)

② 비대칭 암호화 : A의 공개키로 암호화 한 내용은 A의 개인키로만 풀 수 있다. 비대칭 암호화는 대칭 암호화에 비해 상당히 느리다.

2. 무결성(Integrity) : Date가 불법수정되지 못하게 보장한다. 암호화된 메시지 축약을 서명(signature)이라고 한다.

3. 인증(Authentication) : 상호 교신하는 사람이 각각 믿을수 있는 객체임을 보장한다.

인증서는 한 사람에 의해 발급되는 문장으로 다른 사람의 공개키를 가지는 어떤 값이다. 필수적으로 인증서는 서명된 공개키이다.

■ 알고리즘

비대칭 암호화와 서명은 다양한 키 크기를 가진다. 적절한 키 크기를 선태가하는 것은 사용자와 애플리케이션에 달려 있다.

명 칭
타 입
비 고

MD-5
메시지 축약
128비트 메시지 축약 생성

저항력에 약간의 허점을 발견

SHA-1
메시지 축약
160비트의 메시지 축약 생성

저항력이 증가

HmacMD5와 HmacSHA1
메시지 인증 코드


DSA
서명
512 ~ 1024비트 까지의 키 생성

ElGamal 서명
서명


DES
대칭 암호화


DESede
대칭 암호화


PBEWithMD5AndDES
대칭 암호화


ElGamal 암호
비대칭 암호화


DH
키 교환

표) 암호화 알고리즘

클래스/인터페이스
정의

java.security.cert.Certificate
암호인증

javax.crypto.Cipher
암호화

java.security.Key. java.security.PrivateKey, java.security.PublicKey, javax.crypto.SecretKey
서명이나 암호화에 사용되는키

javax.crypto.KeyAgreement
비밀키 교환 프로토콜

java.security.KeyFActory
공개키와 비밀키의 형식 변환

javax.crypto.KeyGenerator
대칭암호문에 사용될 키 생성

java.security.KeyPairGenerator
암호화와 인증에 사용된 공개키와 비밀키 생성

javax.crypto.Mac
메시지 인증 코드(MAC)

java.security.MessageDigest
암호화 해시함수

javax.crypto.SecretKeyFactory
비밀키의 형식 변환

java.security.SecureRandom
난수생성

java.security.Signature
전자서명

표) JDK와 JCE에 포함된 암호화 클래스

개념클래스
Sun이 지원하는 암호화 알고리즘
SunJCE가 지원하는 암호화 알고리즘

Cipher

DES, Desede, PBEWithMD5AndDES

KeyAgreement

DH

KeyFactory
DSA


KeyGenerator

DES,DESede

KeyPairGenerator Mac
DSA


Mac

HmacMD5, HmacSHA1

MessageDigest
MD5, SHA-1


SecretKeyFactory

DES, Desede, PBEWithMD5AndDES

Signature
DSA

표) 표준 알고리즘 이름

Chapter 3 난수

Chapter 4 키관리

■ Key 인터페이스

1. java.security.Key 인터페이스( 암호화 키를 캡슐화 )

- public String getAlgorithm() : 키가 사용된 암호 알고리즘 이름을 리턴

- public byte[] getEncoded() : 키의 암호화 값을 구할 수 있다.

- public String getFormat() : 암호화 하는데 사용된 키 포맷의 이름을 리턴한다.

- 자식 인터페이스 : java.security.PublicKey, java.security.PrivateKey,

javax.crypto.SecretKey(JCE)

2 java.security.KeyPair 클래스( 공개키와 개인키 )

- publicKeyPair(PublicKey publicKey, PrivateKey, privateKey) : 주어진 공개키와 개인키로 KeyPair를 생성한다.

- public PublicKey getPublic() : 공개키를 리턴한다.

- public PrivateKey getPrivate() : 개인키를 리턴한다.

■ 키 생성기

1. java.security.KeyPairGenerator( 비대칭 방식 JDK에 포함 )

- public KeyPair generateKeyPair () : 열쇠 페어를 생성합니다.

- public final KeyPair genKeyPair () : 열쇠 페어를 생성합니다.

- public String getAlgorithm () : 이 열쇠 페어 제네레이터의 알고리즘의 표준명을 돌려줍니다.

- public static KeyPairGenerator getInstance (String algorithm) : 지정된 다이제스트 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.

- public static KeyPairGenerator getInstance (String algorithm, String provider) : 지정된 프로바이더로부터 지정된 알고리즘이 사용 가능한 경우에, 그 프로바이더가 제공한 알고리즘을 구현하는 KeyPairGenerator 오브젝트를 작성합니다.

- public final Provider getProvider () : 이 열쇠 페어 제네레이터 오브젝트의 프로바이더를 돌려줍니다.

- pubic void initialize (AlgorithmParameterSpec params) : 제공된 파라미터를 사용하여 KeyPairGenerator를 초기화 한다.

- public void initialize (AlgorithmParameterSpec params, SecureRandom random) : 제공된 파라미터를 사용하여 KeyPairGenerator를 초기화 한다.

- public void initialize (int keysize) : 랜덤 비트의 소스 역할을 하는 새로운 SecureRandom을 생성하는 것을 제외하고 임의의 키 사이즈에 대하여 열쇠 페어 제네리이터를 초기화합니다.

- pubic void initialize (int keysize, SecureRandom random) : 제공된 랜덤 비트 소스를 사용하여 임의의 키 사이즈 대하는 열쇠 페어 제네레이터를 초기화합니다.

KeyPairGenerator kpg = KeyPairGenerator.getInstance("DSA");

kpg.initialize(1024);

KeyPair pair = kpg.getKeyPair();

2. javax.crypto.KeyGenerator( 대칭 방식 JCE에 포함 )

- public final SecretKey generateKey() : 새로운 랜덤 SecretKey를 생성한다.

- public String getAlgorithm() : KeyGenerator 객체에 사용된 알고리즘의 이름을 리턴합니다.

- public static KeyGenerator getInstance(.String algorithm) : 주어진 알고리즘으로 인스턴스 생성

- pubic static KeyGenerator getInstance(String algorithm, String provider) : 주어진 알고리즘과 프로바이터로 인스턴스 생성

- pubic Provider getProvider() : 사용된 프로바이터 리턴

- public void init(AlgorithmParameterSpec params) : 제공된 파라미터를 사용하여 초기화 한다.

- public void init(AlgorithmParameterSpec params, SecureRandom random) : 제공된 파라미터를 사용하여 초기화 한다.

- public void init(int keysize) : 주어진 크기로 키를 생성하기 위하여 초기화한다.

- public void init(int keysize, SecureRandom random) : 주어진 키와 랜덤소스로 초기화 한다.

- public void init(java.security.SecureRandom random) : 주어진 랜덤소스로 초기화 한다.

KeyGenerator kg = KeyGenerator.getInstance("DES");

kg.init(new SecureRandom());

SecretKey key = kg.generateKey()

■ 키 해석기

키를 저장하는 방법중 하나는 키를 직렬화 하여 저장하는것과 단순히 바이트의 배열과 같이 키를 저장하거나 전송하는 방법이 있다. 키 객체를 바이트로 또는 역으로 변환하는 방법이 다음의 클래스에 정의 되어있다.

1. javax.crypto.spec.SecretKeySpec( 바이트 배열을 비밀키로 변환하는 가장 간단한 방법 )

- SecretKeySpec(byte[] key, int offset, int len, String algorithm) : offset과 제공된 바이트의 배열의 len 바이트를 사용하여 SecretKeySpec을 생성한다. 키는 제공된 알고리즘을 따른다.

- SecretKeySpec(byte[] key, String algorithm) : 제공된 바이트 배열을 사용하여 SecretKeySpec을 생성한다. 키는 제공된 알고리즘을 따른다.

SecureRandom sr = new SecureRandom();

byte[] keyBytes = new byte[20];

sr.nextBytes(keyBytes);

SecretKey key = new SecretKeySpec(keyBytes, "HmacSHA1");

2. javax.crypto.SecretKeyFactory

- public static final SecretKeyFactory getInstance(String algorithm) : 주어진 알고리즘에 대하여 새로운 SecretKeyFactory를 생성한다 알고리즘은 “DES"와 같은 대칭 암호 알고리즘이다.

- pubic static final SecretKeyFactory getInstance(String algorithm, String provider) : 주어진 프로바이더로 SecretKeyFActory를 생성한다.

- public final SecretKey generateSecret(KeySpec keySpec) : KeySpec를 SecretKey로 변환하기 위하여 사용된다.

public SecertKey makeDESKey(byte[] input, int offset)

throws NoSuchAlgorithmException, InvalidkeyException, InvalidkeySpecException{

SecretKeyFactory desFactory = SecretKeyFactory.getInstance("DES");

KeySpec spec = new DESKeySpec(input, offset);

return desFactory.generateSecret(spec);

}

- public final KeySpec getKeySpec(SecretKey key, java.lang.Class keySpec) : 주어진 SecretKey로부터 KeySpec을 생성한다.

public byte[] makeBytesFromDESKey (SecretKey key)

throw NoSuchAlgorithmException, InvaildKeySpecException {

SecretKeyFactory desFactory = SecretKeyFactory.getInstance("DES");

DESKeySpec spec =

(DESKeySpec)desFactory.getKeySpec(Key, DESKeySpec.class);

return spec.getKey();

}

3. java.security.KeyFactory

- public static final KeyFactory getInstance (String algorithm) : 지정된 다이제스트 알고리즘을 구현하는 KeyFactory 오브젝트를 작성합니다. 알고리즘 이름은 비대칭 암호 알고리즘 이름이거나 “DSA"와 같은 서명 알고리즘 이어야 합니다.

- public static final KeyFactory getInstance (String algorithm, String provider) : 지정된 프로바이더로부터, 지정된 알고리즘의 KeyFactory 오브젝트를 작성합니다.

- public final PrivateKey generatePrivate (KeySpec keySpec) : 지정된 열쇠 사양 (열쇠 데이터)으로부터 개인키를 생성하는데 사용

- public final PublicKey generatePublic (KeySpec keySpec) : 지정된 열쇠 사양 (열쇠 데이터)으로부터 공개키를 생성하는데 사용

- public final KeySpec getKeySpec (Key key, Class keySpec) : 주어진 키로부터 키 스펙을 생성한다.

■ 키 교환 프로토콜

1. javax.crypto.KeyAgreement

- public static final KeyAgreement getInstance(String algorithm) : 주어진 알고리즘을 사용하여 새로운 KeyAgreement를 생성한다. 이름은 “DH"와 같은 키교환 알고리즘이어야 한다.

- public static final KeyAgreement getInstance(String algorithm, String provider) : 주어진 알고리즘과 프로바이더로 새로운 KeyAgreement를 생성한다.

- public final void init(Key key) : 제공된 키를 사용하는 KeyAgreement를 초기화 한다.

- public final void init(Key key, AlgorithmParameterSpec params) : 주어진 키와 알고리즘 지정 파라미터를 사용하여 KeyAgreement를 초기화 한다.

- public final void init(.Key key, AlgorithmParameterSpec params, SecureRandom random) : 주어진 키와 알고리즘 지정 파라미터 그리고 랜덤 소스를 사용해서 KeyAgreement를 초기화 한다.

- public final void init(Key key, SecureRandom random)

- public final Key doPhase(Key key, boolean lastPhase)

- public final byte[] generateSecret()

- public final int generateSecret(byte[] sharedSecret, int offset)

- public final SecretKey generateSecret(java.lang.String algorithm)

- public final String getAlgorithm()

- public final Provider getProvider()

// --< Skip Server >

package test.crypto.part5;

import java.security.*;

import java.net.*;

import java.io.*;

import java.security.spec.*;

import javax.crypto.*;

import sun.misc.*;

public class SkipServer {

public SkipServer() {

}

public void exec(int port) throws Exception {

//Diffie-Hellman 키 쌍 생성

KeyPairGenerator kpg = KeyPairGenerator.getInstance("DH");

kpg.initialize(Skip.sDHParameterSpec);

KeyPair keypair = kpg.genKeyPair();

// 연결을 기다린다.

ServerSocket ss = new ServerSocket(port);

System.out.println("요청을 기다리고 있습니다.... port : "+port);

Socket s = ss.accept();

DataOutputStream out = new DataOutputStream(s.getOutputStream());

DataInputStream in = new DataInputStream(s.getInputStream());

/**

* 첫번째 클라이언트는 서버에 바이트 배열의 코드화된

* Difie-Hellman공개키를 보낸다.

* KeyFactory가 그 키를 재구성하기 위해 사용된다.

*/

// 공개키를 받는다.

byte[] keyBytes = new byte[in.readInt()];

in.readFully(keyBytes);

KeyFactory kf = KeyFactory.getInstance("DH");

X509EncodedKeySpec x509Spec = new X509EncodedKeySpec(keyBytes);

PublicKey theirPublicKey = kf.generatePublic(x509Spec);

// 우리의 키를 클라이언트에게 보낸다.

keyBytes = keypair.getPublic().getEncoded();

out.writeInt(keyBytes.length);

out.write(keyBytes);

/**

* 이제 개인키와 클라이언트의 공개키를 사용해서 보안값을 계산할수 있다.

* 그 보안 값은 Diffie-Hellman 키를 생성

* 하기 위해 사용된 계수만큼 길다. 이 경우 보안값은

* 1024비트 길이를 가진다.

*/

KeyAgreement ka = KeyAgreement.getInstance("DH");

ka.init(keypair.getPrivate());

ka.doPhase(theirPublicKey,true);

byte[] secret = ka.generateSecret();

out.close();

in.close();

BASE64Encoder encoder = new BASE64Encoder();

System.out.println(encoder.encode(secret));

}

public static void main(String[] args) throws Exception {

if(args.length < 1) {

System.out.println("포트 번호를 입력해주셔야 합니다...");

System.exit(0);

}

SkipServer skipServer = new SkipServer();

skipServer.exec(Integer.parseInt(args[0]));

}

}

//--- < Skip Client >

package test.crypto.part5;

import java.security.*;

import java.net.*;

import java.io.*;

import java.security.spec.*;

import javax.crypto.*;

import sun.misc.*;

public class SkipClient {

public SkipClient() {

}

public void exec(String ip, int port) throws Exception {

//Diffie-Hellman 키 쌍 생성

KeyPairGenerator kpg = KeyPairGenerator.getInstance("DH");

kpg.initialize(Skip.sDHParameterSpec);

KeyPair keypair = kpg.genKeyPair();

// 네트워크 연결

Socket s = new Socket(ip, port);

DataOutputStream out = new DataOutputStream(s.getOutputStream());

DataInputStream in = new DataInputStream(s.getInputStream());

// 공개키 전송

byte[] keyBytes = keypair.getPublic().getEncoded();

out.writeInt(keyBytes.length);

out.write(keyBytes);

// 공개키 수신

keyBytes = new byte[in.readInt()];

in.readFully(keyBytes);

KeyFactory kf = KeyFactory.getInstance("DH");

X509EncodedKeySpec x509Spec = new X509EncodedKeySpec(keyBytes);

PublicKey theirPublicKey = kf.generatePublic(x509Spec);

/**

* 이제 개인키와 클라이언트의 공개키를 사용해서 보안값을 계산할수 있다. 그 보안 값은 Diffie-Hellman 키를 생성

* 하기 위해 사용된 계수만큼 길다. 이 경우 보안값은 1024비트 길이를 가진다.

*/

KeyAgreement ka = KeyAgreement.getInstance("DH");

ka.init(keypair.getPrivate());

ka.doPhase(theirPublicKey,true);

byte[] secret = ka.generateSecret();

out.close();

in.close();

BASE64Encoder encoder = new BASE64Encoder();

System.out.println(encoder.encode(secret));

}

public static void main(String[] args) throws Exception {

if(args.length < 2) {

System.out.println("서버 아이피와 포트 번호를 입력해주셔야 합니다...");

System.exit(0);

}

SkipClient skipClient = new SkipClient();

skipClient.exec(args[0], Integer.parseInt(args[1]));

}

}

■ KeyStore 클래스의 키 관리 패러다임

1. 인스턴스 생성

- public static final KeyStore getInstance (String type) : 지정된 타입의 키 스토어 오브젝트를 작성합니다. KeyStore ks = KeyStore.getInstance("JKS");

- public static final KeyStore getInstance (String type, String provider) : 지정된 프로바이더로부터, 지정된 키 스토어 타입의 키 스토어 오브젝트를 작성합니다. KeyStore ks = KeyStore.getInstance("JKS", "SUN");

2. 로딩과 저장

- public final void load (InputStream stream, char[] password) : 지정된 입력 Stream로부터 이 키 스토어를 로드합니다.

- public final void store (OutputStream stream, char[] password) : 지정된 출력 Stream에 이 키 스토어를 격납 해, 지정된 패스워드로 그 완전성을 보호합니다

향후 내용 추가 요망....

Chapter 5 인증

인증에 유요한 세가지 암호화 개념

- 메시지 축약(message digest)은 대용량 데이터 집합을 나타내는 식별자를 생성한다.

- 전자 서명(digital signature)은 데이터의 무결성을 증명하는데 사용한다.

- 인증서(certificate)는 암호적으로 공개키의 안전한 컨테이너로 사용된다.

■ 변경된 메시지 축약

package test.crypto.part6;

import java.security.*;

import java.io.*;

import sun.misc.*;

public class MessageDigestTester {

public MessageDigestTester() {

}

private void exec(String targetFileName) {

try {

// MD5알고리즘을 이용한 메시지 축약 객체를 생성한다.

MessageDigest md = MessageDigest.getInstance("MD5");

// 주어진 파일에 대한 축약 값 계산

DigestInputStream in = new DigestInputStream(new FileInputStream(targetFileName), md);

byte[] buffer = new byte[8192];

while ( in.read(buffer) != -1 ) {

}

byte[] raw = md.digest();

// 출력 가능한 문자열로 변환한다.

BASE64Encoder encoder = new BASE64Encoder();

String base64 = encoder.encode(raw);

System.out.println(base64);

} catch(NoSuchAlgorithmException nalgoe) {

System.err.println(nalgoe);

} catch(FileNotFoundException fnote) {

System.err.println(fnote);

} catch(IOException ioe) {

System.err.println(ioe);

}

}

public static void main(String[] args) {

if(args.length < 1) {

System.out.println("메시지 축약의 대상 파일을 선택하여 주십시요");

System.exit(0);

}

String targetFileName = args[0];

MessageDigestTester masher = new MessageDigestTester();

masher.exec(targetFileName);

}

}

■ 암호화된 패스워드 로그인

클라이언트에서 서버로 평문을 전송하는 것을 피하기 위해서, 클라이언트는 평문 대신에 패스워드 메시지를 축약하여 보내게 되며, 서버는 보유하고 있는 패스워드 사본의 메시지 축약을 비교하여 두 개의 메시지 축약 내용이 같을 경우에 클라이 언트를 인증하게 된다.

//--- < masher Server >

package test.crypto.part6;

import java.util.*;

import java.net.*;

import java.io.*;

import java.security.*;

public class MasherServer {

public MasherServer() {

}

public void exec(int port) throws Exception {

ServerSocket ss = new ServerSocket(port);

System.out.println("요청을 기다리고 있습니다.... port : "+port);

Socket s = ss.accept();

DataInputStream in = new DataInputStream(s.getInputStream());

// 클라이언트가 보낸 순서로받는다.

String user = in.readUTF();

long time = in.readLong();

double randomQ = in.readDouble();

int leng = in.readInt();

byte[] masherBytesIn = new byte[leng];

in.readFully(masherBytesIn);

byte[] masherBytesOut = userMasher.makeDigest(user, getPassword(), time, randomQ);

if(isUser(masherBytesIn, masherBytesOut)) {

System.out.println("Login");

} else {

System.out.println("No password");

}

in.close();

}

private String getPassword() {

return "rlarudwls";

}

private boolean isUser(byte[] inBytes, byte[] outBytes){

return MessageDigest.isEqual(inBytes, outBytes);

}

public static void main(String[] args) throws Exception {

if(args.length < 1) {

System.out.print("포트를 입력하여 주십시요....");

System.exit(0);

}

MasherServer ms = new MasherServer();

ms.exec(Integer.parseInt(args[0]));

}

}

//---< masherClient >

package test.crypto.part6;

import java.util.*;

import java.net.*;

import java.io.*;

public class MasherClient {

public MasherClient() {

}

public void exec(String user, String password, String host, int port) throws Exception {

Date date = new Date();

long time = date.getTime();

double randomQ = Math.random();

byte[] masherBytes = userMasher.makeDigest(user, password, time, randomQ);

Socket s = new Socket(host, port);

DataOutputStream out = new DataOutputStream(s.getOutputStream());

out.writeUTF(user);

out.writeLong(time);

out.writeDouble(randomQ);

out.writeInt(masherBytes.length);

out.write(masherBytes);

out.flush();

out.close();

}

public static void main(String[] args) throws Exception {

if(args.length < 2) {

System.out.print("서버 주소와 포트를 입력하여 주십시요....");

System.exit(0);

}

String user = "inter999";

String password = "rlarudwls";

MasherClient mc = new MasherClient();

mc.exec(user, password, args[0], Integer.parseInt(args[1]));

}

}

package test.crypto.part6;

import java.io.*;

import java.security.*;

public class userMasher {

public static byte[] makeDigest(String user, String password, long time, double randomQ)

throws NoSuchAlgorithmException {

MessageDigest md = MessageDigest.getInstance("SHA");

md.update(user.getBytes());

md.update(password.getBytes());

md.update(makeBytes(time, randomQ));

return md.digest();

}

public static byte[] makeBytes(long time, double randomQ) {

try {

ByteArrayOutputStream byteout = new ByteArrayOutputStream();

DataOutputStream dataout = new DataOutputStream(byteout);

dataout.writeLong(time);

dataout.writeDouble(randomQ);

return byteout.toByteArray();

} catch (IOException ioe) {

return new byte[0];

}

}

}

■ 이중 암호화 패스워드 로그인

메시지 축약을 사용하여 패스워드 정보를 보호하는 강력한 방법으로 이중 암호화 기법이 있는데, 이의 구성은 “암호화 패스워드 로그인”에 추가적으로 타임스템프와 난수를 포함한다. 즉 두 번째 축약에서 처음 축약메시지와 타임스템프, 난수를 이용하여 축약한다.

■ MAC

이 클래스는 메시지 인증 코드(MAC)에 대한 API를 정의한다. MAC은 비밀키를 공유하는 두 집단 사이에서 전송되는 정보의 무결성을 검사할 수 있다. MAC은 공개키/개인키가 아니라 비밀키와 함께 생성된다는 점을 제외하면 디지털 서명과 비슷하다. MAC 클래스는 알고리즘과 무관하며 제공자-기반이다. 정적 getInstance() 팩토리 메소드 중 하나를 호출하여 희망하는 MAC 알고리즘의 이름을 지정하여 MAC 객체를 얻는다.

“SunJCE"제공자는 ”HmacMD5", "HmacSHA1"이라는 두 개의 알고리즘을 구현한다.

1. Mac 객체를 얻은 후에는 init() 메소드를 호출하여 SecretKey를 지정하여 이 Mac 객체를 초기화 한다.

2. Mac 객체를 얻고 초기화 한 후에는, Mac이 계산될 데이터를 지정한다. 단순히 단일 바이트 배열을 처리 할때는 doFinal()에 전달하고, 스트리밍이나 다양한 위치에 저장된다면 update()를 여러번 호출하여 처리한다.

SecureRandom sr = new SecureRandom();

byte[] keyBytes = new byte[20];

sr.nextBytes(keyBytes);

SecretKey key = new SecretKeySpec(keyBytes, "HmacSHA1");

Mac m = Mac.getInstance("HmacSHA1");

m.init(key);

m.update(inputData);

byte[] mac = m.doFinal();

■ 서명(java.security.Signature)

서명은 두 가지 보안 서비스(인증과 무결성) 즉, 메시지가 변조되어 오지 않는 것과 메시지가 어떤 사람으로부터 보내졌는지를 보장해준다. 서명은 서명한 사람의 개인키를 가지고 암호화한 메시지 축약이다. 서명한 사람의 공개키만이 서명을 복호화 할 수 있으며, 이것이 인증을 제공한다. 메시지 축약이 서명으로부터 복호화한 메시지 축약과 같다면, 무결성 역시 보장되는 것이다.

1. Signature 객체는 정적 팩토리 메소드인 getInstance()중의 하나를 원하는 전자 서명 알고리즘과 선택적으로 알고리즘의 제공자를 지정하면서 호출하여 얻을 수있다.

2. 전자 서명은 본질적으로 공개키 암호화 알고리즘으로 암호화된 메시지 축약이다. 따라서 전자 서명 알고리즘을 지정하려면, 축약 알고리즘과, 암호화 알고리즘을 모두 지정해야한다.

3. 기본 “SUN"제공자에서 지원되는 유일한 알고리즘은 ”SHA1WwithDSA"이다.

4. 전자 서명의 생성을 위한 초기화를 하려면 initSign()을 호출하고 서명 생성을 위한 개인키를 지정해야한다.

5. 서명의 검증을 위한 초기화를 하려면 initVerify()를 호출하고 사인자(signer)의 공개키를 지정해야 한다.

6. Signature 객체가 초기화 되었으면 update()를 한번 이상 호출하여 사인되거나 검증될 바이트를 지정한다.

7. 마지막으로 전자 서명을 생성하기 위해 sign()을 호출하면서 사인이 저장될 바이트 배열을 넘겨준다.

// 핼퍼클래스

package acdpu.pki;

import java.io.Serializable;

import java.security.PrivateKey;

import java.security.PublicKey;

public class PKIHelper implements Serializable {

private String userId;

private String passwd;

private String createDate;

private String destroyDate;

private PrivateKey privatekey;

private PublicKey publickey;

public String getUserId() {

return userId;

}

public void setUserId(String newUserId) {

userId = newUserId;

}

public String getPasswd() {

return passwd;

}

public void setPasswd(String newPasswd) {

passwd = newPasswd;

}

public String getCreateDate() {

return createDate;

}

public void setCreateDate(String newCreateDate) {

createDate = newCreateDate;

}

public String getDestroyDate() {

return destroyDate;

}

public void setDestroyDate(String newDestroyDate) {

destroyDate = newDestroyDate;

}

public PrivateKey getPrivatekey() {

return privatekey;

}

public void setPrivatekey(PrivateKey newPrivatekey) {

privatekey = newPrivatekey;

}

public PublicKey getPublickey() {

return publickey;

}

public void setPublickey(PublicKey newPublickey) {

publickey = newPublickey;

}

}

// 컨트롤러

package acdpu.pki;

import java.security.*;

import acdpu.pki.exception.*;

public class PKIController {

public PKIController() {

}

public PrivateKey createKeyPair(String userid, String passwd)

throws PKICreateException, IncorrectUserException, TermExpirationException, PKIDBHandlerException {

try{

KeyPairGenerator kpg = KeyPairGenerator.getInstance("DSA", "SUN");

kpg.initialize(1024,SecureRandom.getInstance("SHA1PRNG"));

KeyPair keypair = kpg.genKeyPair();

PKIDBHandler.userConfirm(userid, passwd);

PKIHelper pkihelper = new PKIHelper();

pkihelper.setUserId(userid);

pkihelper.setPasswd(passwd);

pkihelper.setPrivatekey(keypair.getPrivate());

pkihelper.setPublickey(keypair.getPublic());

PKIDBHandler.saveKeyPair(pkihelper);

return pkihelper.getPrivatekey();

} catch (NoSuchProviderException nope) {

throw new PKICreateException("NoSuchProvider");

} catch (NoSuchAlgorithmException noae) {

throw new PKICreateException("NoSuchAlgorithm");

}

}

public void loginPKI(String userid, String passwd, byte[] signature)

throws PKIInvalidException, IncorrectUserException, TermExpirationException, PKIDBHandlerException {

PKIDBHandler.userConfirm(userid, passwd);

PKIDBHandler.verify(userid, passwd, signature);

}

public static void main(String[] args) {

PKIController pKIController = new PKIController();

}

}

// 데이터 모델

package acdpu.pki;

import java.sql.*;

import java.io.*;

import acdpu.pki.exception.*;

import java.security.*;

import java.security.spec.*;

public class PKIDBHandler {

public static boolean saveKeyPair(PKIHelper pkihelper)

throws PKIDBHandlerException {

Connection con = null;

PreparedStatement pstmt = null;

ResultSet rs = null;

try {

Class.forName("oracle.jdbc.driver.OracleDriver");

con = DriverManager.getConnection("jdbc:oracle:thin:@ 218.145.231.3:1522:ora8", "itdev", "itdev");

con.setAutoCommit(false);

StringBuffer sbSQL = new StringBuffer();

sbSQL.append("update TB_PKI set privatekey = ?, publickey = ?, indate=sysdate where userid='"+pkihelper.getUserId()+"'");

pstmt = con.prepareStatement(sbSQL.toString());

ByteArrayInputStream privateKeywriter = new ByteArrayInputStream(pkihelper.getPrivatekey().getEncoded());

ByteArrayInputStream publicKeywriter = new ByteArrayInputStream(pkihelper.getPublickey().getEncoded());

pstmt.setBinaryStream(1,privateKeywriter,privateKeywriter.available());

pstmt.setBinaryStream(2,publicKeywriter,publicKeywriter.available());

pstmt.executeUpdate();

privateKeywriter.close();

publicKeywriter.close();

con.commit();

return true;

} catch(ClassNotFoundException cnote) {

throw new PKIDBHandlerException("PKIDBHandler.saveKeyPair Method Error : Message = "+cnote.getMessage());

} catch(IOException io) {

throw new PKIDBHandlerException("PKIDBHandler.saveKeyPair Method Error : Message = "+io.getMessage());

} catch(SQLException e) {

try{

con.rollback();

con.setAutoCommit(true);

}catch(Exception er){}

throw new PKIDBHandlerException("PKIDBHandler.saveKeyPair Method Error : Message = "+e.getMessage());

} finally {

try {

con.setAutoCommit(true);

if(rs !=null ) {

rs.close();

rs=null;

}

if(pstmt !=null ) {

pstmt.close();

pstmt = null;

}

if(con!=null && !con.isClosed()) {

con.close();

con =null;

} else {

con=null;

}

} catch(Exception e) {

rs = null;

pstmt = null;

con = null;

}

}

}

public static void verify(String userid, String passwd, byte[] signature)

throws PKIInvalidException, PKIDBHandlerException {

Connection con = null;

PreparedStatement pstmt = null;

ResultSet rs = null;

try {

Class.forName("oracle.jdbc.driver.OracleDriver");

con = DriverManager.getConnection("jdbc:oracle:thin:@ 218.145.231.3:1522:ora8", "itdev", "itdev");

StringBuffer sbSQL = new StringBuffer();

sbSQL.append("select publickey from TB_PKI where userid ='"+userid+"'");

pstmt = con.prepareStatement(sbSQL.toString());

rs = pstmt.executeQuery();

&

java.lang.OutOfMemoryError

                     2005-05-31     송학렬    ㈜아이티플러스 기술지원부

이 문서는 기술지원 또는 개발 시 java.lang.OutOfMemoryError 를 만났을 때 원인 파악 및 해결방안 입니다.

java.lang.OutOfMemoryError 에는 크게 2가지 패턴이 있다고 볼 수 있습니다.(전적으로 개인적인 생각이지만..^^)

Java의 heap 메모리가 정말로 Full 되서 나는 종류가 있고 그렇지 않은데도 나는 종류가 있습니다.

그 둘 중에 어는 것 인지부터 가려내는 것이 가장 먼저 선행되어야 합니다.

Java 가상머신에는 메모리 구조가 여러단계로 나뉘어 져 있으므로 어느 영역에 의해 java.lang.OutOfMemoryError 가 나는지 알기 위해 JAVA OPTION으로 싸이트가 안정화 되기 전까진 –verbosegc 또는 -XX:+PrintGCDetails  옵션을 추가해 놓는 것이 java.lang.OutOfMemoryError 났을 때를 대비해 좋은 습관이라 할 수 있습니다.

-verbosegc 또는  -XX:+PrintGCDetails  옵션으로 로그에 남는 heap 메모리 정보를 본 후 java.lang.OutOfMemoryError 가 날 때 heap이 꽉 차서 나는 것인지 아닌지 부터 판단합니다.

1.     Heap Memory가 Full 차지 않았을 때

1)     Perm 영역이 full 되는 경우

Permanent generation is full...

increase MaxPermSize (current capacity is set to: 134217728 bytes)

[Full GC[Unloading class sun.reflect.GeneratedSerializationConstructorAccessor31282]

 810207K->802132K(1013632K), 8.3480617 secs]

<GC: 2 4  2465625.831280 10348 0 31 113802808 105534632 286326784 0 0 35782656 715849728 715848840 715849728 134217720 134023296 134217728 8.348677 8.348677 >

Passwd Check =============

<2005. 5. 19. 오전 9시 32분 23초 KST> <Error> <HTTP> <BEA-101017> <[ServletContext(id=2536415,name=/,context-path=)] Root cause of ServletException.

java.lang.OutOfMemoryError

위와 같은 case 인 경우네는 Java 가상머신중에 Perm 영역이 full 차는 경우 입니다. 

Perm 영역에는 class object 및 관련된 meta data가 로드되는 곳인데 싸이트가 매우 많은 수의 class를 사용하는 경우 늘려줘야 하는 case도 있습니다.

얼마가 적정한 사이즈란 정답이 없는 것 같고 max가 계속 늘어나지 않고 일정한 사이즈를 유지 하면 됩니다.

             위 에러가 났을때는 -XX:MaxPermSize=256m  옵션으로 사이즈를 적당하게 늘려주는게 방

             법이며 늘려주었는데도 불구하고 Full 차는 시간만 늘어날 뿐 계속 사이즈가 늘어난다면 이 영역은 일반 비즈니스 프로그램으로 핸들링 할 수 없는 영역이므로 WAS 제품의 버그 및 jdk 버그로 보는 것이 일반적입니다.

2)     MAXDSIZ 사이즈 관련

  - Exception in thread "CompileThread0" java.lang.OutOfMemoryError: requested 32756 bytes for ChunkPool::allocate

Possible causes:

         - not enough swap space left, or

         - kernel parameter MAXDSIZ is very small.

-          java.lang.OutOfMemoryError: unable to create new native thread

위 두 에러가 나는 이유는 Data 사이즈가 Full 차서 더 이상 메모리 할당을 할 수 없다는 java.lang.OutOfMemoryError 입니다.

Jdk도 내부적으로 c 라이브러리를 쓰고 jni를 통해서 c프로그램을 호출할 수 도 있는 환경에서 Data 영역이상으로 메모리 사용 시 위 에러를 만날 수 있습니다.

Heap 영역에는 java heap과 C heap이 있는데 C heap이 Data 메모리 영역에 영향을 미치는 것으로 보이며 보통 C의 전역 변수들이 잡히는 영역입니다.

위 현상을 만났을 때는 hp os의 MAXDSIZ가 너무 작게 잡혀있지 않은지 확인 후 적당한 크기로 늘려 줘야 합니다.

Glance 에서 shift+m 을 누른 후 jvm pid를 누르면 java가 사용하는 Data 사이즈를 모니터링 할 수 있습니다.

모니터링을 통해 적정한 사이즈로 MAXDSIZ를 늘려주어야 하며 만일 늘려 준게 에러 발생의 시간만 지연 시킬 뿐 계속 사용량이 늘어난다면 이는 사용하는 c라이브러리 쪽에 메모리 릭 버그가 있는 것이므로 c라이브러리를 체크 하셔야 합니다.

java.lang.OutOfMemoryError: unable to create new native thread

이 경우는 프로그램에서 Thread pool 프로그램 실수로 필요이상으로 쓰레드가 생성되는 경우도 과도하게 메모리를 사용할 수 있으므로 jvm 쓰레드 덤프를 통해 과도한 쓰레드가 생성되지 않았는지도 확인해 보셔야 합니다.

2.     Heap이 Full 찾을 때

이 경우는 java가 사용하는 heap 영역이 Full 되서 java.lang.OutOfMemoryError 가 나는 경우 인데 두 가지 패턴이 있습니다.

순간적으로 대량의 데이터를 메모리에 올리는 프로그램이 실행되어 문제를 야기 할수 있으며 다른 한 가지는 조금씩 메모리 릭이 발생하여 점차적으로 메모리가 쌓여 가는 경우 입니다.

두 가지 중에  어느 것인지 구별하는 것이 중요하며 이를 위해서도 마찬가지로 -verbosegc 또는  -XX:+PrintGCDetails  로그를 통해 순간적으로 메모리가 차는 것인지 조금씩 메모리가 차는 것인지를 확인하셔야 합니다.

1) 특정 프로그램의 특정시점의 과도한 메모리 사용에 의한 경우

                특정 프로그램이 과도하게 heap 메모리 이상 메모리를 사용하면서

java.lang.OutOfMemoryError가 발생하는 경우는 이 에러가 발생하는 시점의 쓰레드 덤프를 통해 어느 프로그램인지 쉽게 찾을 수 있습니다.

쓰레드 덤프에 메모리를 쓸만한 프로그램은 어느 정도의 자바프로그램 경험이 있으면 찾을 수 있습니다.

Ex)

"ExecuteThread: '36' for queue: 'default'" daemon prio=10 tid=0x0048e7b0 nid=48 lwp_id=4139729 runnable [0x23f32000..0x23f30500]

          at java.net.SocketInputStream.socketRead(Native Method)

          at java.net.SocketInputStream.read(Unknown Source)

          at oracle.net.ns.Packet.receive(Unknown Source)

          at oracle.net.ns.NetInputStream.getNextPacket(Unknown Source)

          at oracle.net.ns.NetInputStream.read(Unknown Source)

          at oracle.net.ns.NetInputStream.read(Unknown Source)

          at oracle.net.ns.NetInputStream.read(Unknown Source)

          at oracle.jdbc.ttc7.MAREngine.unmarshalUB1(MAREngine.java:718)

          at oracle.jdbc.ttc7.MAREngine.unmarshalSB1(MAREngine.java:690)

          at oracle.jdbc.ttc7.Oall7.receive(Oall7.java:373)

          at oracle.jdbc.ttc7.TTC7Protocol.doOall7(TTC7Protocol.java:1405)

          at oracle.jdbc.ttc7.TTC7Protocol.fetch(TTC7Protocol.java:889)

          - locked <0x35e8e3b0> (a oracle.jdbc.ttc7.TTC7Protocol)

          at oracle.jdbc.driver.OracleResultSetImpl.next(OracleResultSetImpl.java:242)

          - locked <0x36f66c98> (a oracle.jdbc.driver.OracleResultSetImpl)

          at weblogic.jdbc.pool.ResultSet.next(ResultSet.java:180)

          at Dcard.AAA.ejb.monitor.member.wbbb.WACBean.getInfoList(WACBean.java:5789)

java.lang.OutOfMemoryError 가 날 상황에 쓰레드 덤프를 두 세번 떠서 같은 쓰레드 번호로 위 같은 로직이 오래 결려있다면 이는 프로그램에서 while(rs.next()) 를 오랜 기간 돌면서 메모리에 DB로부터 읽어서 올리고 있다는 것을 의미 합니다… 대량 데이터 조회가 일어나는 경우인 것 입니다.

이런 식으로 특정 프로그램의 특정 시점에 과도한 메모리 사용으로 인한 java.lang.OutOfMemoryError 에러는 쓰레드 덤프를 통해 찾을 수 있습니다.

-- 물론 2번에서 설명 할 heap dump를 통해서도 찾을 수 있습니다.

2) 메모리 릭에 의해 조금씩 메모리가 쌓인 경우

JVM위 에서 실행중인 프로그램중에 어떤 것이 GC 대상에서 제외되는 영역에 data를 조금씩 쌓고 있다는 얘기입니다.

GC 대상에서 제외되는 영역은 다음과 같은 곳이 있습니다.

- Http Session에 넣는 데이터..(세션 타임아웃 또는 invilidate 씨 까지 제외됨)

- Static 변수

- 서블릿 또는 jsp의 멤버변수 ( WAS 기동 후 최초 호출 시 인스턴스 화 되어 WAS가 내려 갈 때 까지 사라지지 않음 )

- EJB의 멤버변수( pool안에서 객체가 존재하는 한 GC대상에서 제외)

          위 같은 영역에 프로그램에서 data를 add 하는 구조를 메모리 릭 이라고 할 수 있습니다.

           IBM 또는 SUN JDK 인 경우에는 heapdump를 통해서 분석하여 어느 데이터가 메모리를 많이 잡고 있는지를 알 수 있습니다.

           Heapdump 사용법 및 분석 법은 다음을 참조 하시면 됩니다.

 http://www.alphaworks.ibm.com/aw.nsf/FAQs/heaproots

http://www-1.ibm.com/support/docview.wss?uid=swg21190476

http://www-1.ibm.com/support/docview.wss?rs=180&context=SSEQTP&q1=heapdump+solaris&uid=swg21190608&loc=en_US&cs=utf-8&lang=en

http://www.skywayradio.com/tech/WAS51/IBMHeapDump/

JSP에서 원하는 Appender 선택하여 쓰기

참고로 이글의 원저자는 제가 아니므로 퍼가셔서 사용하실때 신중해주시기 바랍니다

만약 log4j 가 처음이라면 이 카테고리의 다음 포스트를 먼저 필독하세요

- log4j 웹에서 사용하기

- log4j 고급스럽게 사용하기

I. 먼저 log4j 프로퍼티 파일입니다

log4j.properties

log4j.logger.jsp1=INFO, stdout1
log4j.logger.jsp2=INFO, stdout2
jsp1과 jsp2의 두개의 logger를 정의합니다

jsp1 logger는 appender로 stdout1을 사용하며, jsp2 logger는 appender로 stdout2로 사용한다는 의미입니다

log4j.additivity.jsp1=false

additivity 속성은 jsp1 logger를 상위 로거(root logger)의 속성을 삭송받지 않겠다는 의미입니다

만약 이 속성이 없으면 동일한 메세지가 여러번 로깅될 것입니다

이하 속성은

http://www.jakartaproject.com/article/jakarta/1110438405982 등의 사이트를 참고하세요

II. JSP 샘플 소스

test_jsp1_appender.jsp

로깅 메세지

test_jsp2_appender.jsp

로깅 메세지

1. 폰트파일(nGulim.ttf)를 폰트 매트릭스 파일(nGulim.xml)로 바꾼다

java -cp D:\work\FopToPdf\WebContent\WEB-INF\lib\fop.jar;D:\work\FopToPdf\WebContent\WEB-INF\lib\avalon-framework.jar;D:\work\FopToPdf\WebContent\WEB-INF\lib\commons-logging.jar;D:\work\FopToPdf\WebContent\WEB-INF\lib\commons-io.jar org.apache.fop.fonts.apps.TTFReader D:\Temp\fop\nGulim.ttf D:\Temp\fop\nGulim.xml

2. 폰트파일과 폰트매트릭스 파일을 컨피그에 등록.

<font metrics-url="D:\Temp\fop\nGulim.xml" embed-url="D:\Temp\fop\nGulim.ttf" kerning="yes">
    <font-triplet name="NewGulim" style="normal" weight="normal"/>
    <font-triplet name="NewGulim" style="normal" weight="bold"/>
</font>

3. 컨피그를 사용하겠다고 알림

// 유저가 설정한 컨피그 파일을 사용한다. 밑에서 유저 에이전트를 생성하기 전에 컨피그 파일을 설정해야 폰트 등이 적용된다
fopFactory.setUserConfig(new File("d:/Temp/fop/mycfg.xml")); 

FOUserAgent foUserAgent = fopFactory.newFOUserAgent();

.

.

.

4. fo 파일을 EUC-KR로 사용, 사용할 폰트를 설정

<?xml version="1.0" encoding="EUC-KR"?>
<fo:root font-family="NewGulim" font-size="12pt" font-style="normal" font-weight="normal" text-align="center" xmlns:fo="http://www.w3.org/1999/XSL/Format">
  <fo:layout-master-set>
    <fo:simple-page-master master-name='simpleA4' page-height='29.7cm' page-width='21cm' margin-top='2cm' margin-bottom='2cm' margin-left='2cm' margin-right='2cm'>
      <fo:region-body/>
    </fo:simple-page-master>
  </fo:layout-master-set>
  <fo:page-sequence master-reference='simpleA4'>
    <fo:flow flow-name='xsl-region-body'>
      <fo:block>안녕</fo:block>
    </fo:flow>
  </fo:page-sequence>
</fo:root>

JExcelApi(jxl.jar 다운로드)

http://www.andykhan.com/jexcelapi/index.html 에서 download JExcelApi에 가면
(http://www.andykhan.com/jexcelapi/download.html) tar.gz로 되어 있는데 압축풀면 jxl.jar있음

POI다운로드
http://jakarta.apache.org/poi/index.html /download/release

[엑셀파일읽기]

<%@ page language="java" %>
<%@ page contentType="text/html; charset=euc-kr"%>
<%@ page import="java.io.File,jxl.*"%>
<%

Workbook workbook = Workbook.getWorkbook(new File("E:/_Workspace/blr/blr/cms/excel/data/Book1.xls"));

Sheet sheet = workbook.getSheet(0);
Cell a1 = sheet.getCell(0,0);
Cell b2 = sheet.getCell(1,1);
Cell c3 = sheet.getCell(0,2);

String stringa1 = a1.getContents();
String stringb2 = b2.getContents();
String stringc3 = c3.getContents();

workbook.close();

%>

<%=stringa1%>
<%=stringb2%>
<%=stringc3%>


[엑셀파일로 저장]

<%@ page language="java" %>
<%@ page contentType="text/html; charset=euc-kr"%>
<%@ page import="java.io.File,java.util.Date,jxl.*,jxl.write.*"%>
<%
WritableWorkbook workbook = Workbook.createWorkbook(new File("E:/_Workspace/blr/blr/cms/excel/data/aaa.xls"));

WritableSheet sheet = workbook.createSheet("First Sheet", 0);
Label label = new Label(0,2,"A label record");
sheet.addCell(label);

// java.lang.Number 인지 jxl.write.Number  구분해야지^^

jxl.write.Number number = new jxl.write.Number(3,4,3.1415);
sheet.addCell(number);

workbook.write();
workbook.close();
%>

[POI로 테이블에 값넣기] poi.jsp참조

/***************************************************************************************/

엑셀파일처리 POI,JXL비교해 보았습니다.

10000번 for문을 돌려 첫번째 칼럼에 데이타를 입력하였습니다.

이걸 10번 반복한 체크시간입니다.

측정시간단위(밀리세컨)
D:\>java writeTest
============= jxl write time =============
0=>write time::719
1=>write time::281
2=>write time::250
3=>write time::266
4=>write time::234
5=>write time::266
6=>write time::234
7=>write time::266
8=>write time::234
9=>write time::329
=============      end      =============
============= poi write time =============
0=>write time::1110
1=>write time::922
2=>write time::1031
3=>write time::734
4=>write time::1328
5=>write time::766
6=>write time::797
7=>write time::1515
8=>write time::1719
9=>write time::2890
=============      end      =============

거의 2~3배 가까이 시간의 차이가 있더군여.. 단순히 엑셀파일만 다룬다면
jxl패키지를 사용하시는게 훨씬 좋을듯 합니다.

import jxl.*;
import java.io.*;
import java.util.*;

public class ReadXLS
{
   String filename = null;

   //ReadXLS 생성자
   public ReadXLS(String filename)
   {
      this.filename = filename.trim();  
   }

   //String 반환하는 메소드
   public String getData(int row) throws Exception
   {
      //파일 생성및 데이터 선언
      StringBuffer cellData = new StringBuffer();                     
      File file = new File(filename); 

      //존재여부 판단
      if(file.exists())
      {
         //파일여부 판단
         if(file.isFile())
         {
            StringTokenizer st = new StringTokenizer(filename, ".");
            String xls = null;

            //파일 확장자 구하기
            while(st.hasMoreTokens())
            {
               xls = st.nextToken();  
            }

            //확장자 엑셀파일 여부판단
            if(xls.equals("xls"))
            {
               //엑셀정보 에서 쉬트정보 가져오기
               Workbook workbook = Workbook.getWorkbook(file);
               Sheet sheet = workbook.getSheet(0);
              
              //데이터 생성및 구분자 삽입 col=>[xxx] / row=>\n
               for (int i=row; i<sheet.getRows(); i++ )
               { 
                  for (int j=0; j<sheet.getColumns(); j++ )
                  { 
                     Cell cell = sheet.getCell(j,i);
                     cellData.append("["+cell.getContents().trim()+"]");                                  
                  }
                  cellData.append("\n");
               }            
               workbook.close();
            }
            else
            {
               throw new Exception("엑셀파일이 아닙니다.");
            }

         }
         else
         {
            throw new Exception("파일이 아닙니다.");
         }
      }
      else
      {        
         throw new Exception("존재하지 않는 이름 입니다.");
      }           
      return new String(cellData);//String 반환
   }//end getData()

   public static void main(String [] args)
   {
      try
      {
         ReadXLS readxls = new ReadXLS("ex.xls");
         String xls = readxls.getData(0); //0번 행 부터 읽기      
         System.out.println(xls );
      }//End Of try
      catch (Exception e)
      {
         e.printStackTrace();
      }//End Of catch     
   }//End Of Main 
  
}


/*
다음과 같은 프로그램을 컴파일 해서 돌리면(물론 같은 폴더에 ex.xls라는 엑셀 파일을 하나 실험용으로 만들어서 넣어둔다.)
[xxx][xxx][xxx]...
[xxx][xxx][xxx]
[][][][][][][][]
[][][][][][][][]
.
.
.
이런 식으로 결과가 나온다.
프로그램에서 파일겍체를 만들거나 하는것은 안전한 실행을 위해서 한것이고 핵심은 색상이 다른 부분을 중점적으로 보면 될것이다.
*/

Orinoco - A Java API to generate PDF documents

This is the home page of Orinoco: a Java API allowing Java developers to generate PDF documents.

Yet another PDF generator?

There are many Java PDF generators available - why bother with another one? The motivation arose when trying to use a commercially available PDF generator to deliver adhoc reports through a browser. The PDF generator offered everything: charts, drawings, images etc., but all that was required was merely to lay out some text in a tabular format with a few headings in bold. The tool we were using could certainly do this, but when generating larger reports (around 70 pages) it was taking so long to generate the PDF that the HTTP request timed out and the users ended up with nothing.

Rather than spend the time finding another generator and negotiating licensing agreements I decided to write a PDF generator which satisfied our meagre functional requirements and focussed on delivering the generated document quickly.

Orinoco offers the functionality needed to generate text reports (no graphics) and it is very quick: it can generate a document of a couple of hundred pages in a few seconds.

Features

Java Excel API - A Java API to read, write and modify Excel spreadsheets

This is the home page of Java Excel API - open source Java API which allows Java developers to read Excel spreadsheets and to generate Excel spreadsheets dynamically. In addition, it contains a mechanism which allows java applications to read in a spreadsheet, modify some cells and write out the new spreadsheet.

This API allows non Windows operating systems to run pure Java applications which can both process and deliver Excel spreadsheets. Because it is Java, this API may be invoked from within a servlet, thus giving access to Excel functionality over internet and intranet web applications.

Features

JExcelApi(jxl.jar 다운로드)

http://www.andykhan.com/jexcelapi/index.html 에서 download JExcelApi에 가면
(http://www.andykhan.com/jexcelapi/download.html) tar.gz로 되어 있는데 압축풀면 jxl.jar있음

POI다운로드
http://jakarta.apache.org/poi/index.html /download/release

[엑셀파일읽기]

<%@ page language="java" %>
<%@ page contentType="text/html; charset=euc-kr"%>
<%@ page import="java.io.File,jxl.*"%>
<%

Workbook workbook = Workbook.getWorkbook(new File("E:/_Workspace/blr/blr/cms/excel/data/Book1.xls"));

Sheet sheet = workbook.getSheet(0);
Cell a1 = sheet.getCell(0,0);
Cell b2 = sheet.getCell(1,1);
Cell c3 = sheet.getCell(0,2);

String stringa1 = a1.getContents();
String stringb2 = b2.getContents();
String stringc3 = c3.getContents();

workbook.close();

%>

<%=stringa1%>
<%=stringb2%>
<%=stringc3%>


[엑셀파일로 저장]

<%@ page language="java" %>
<%@ page contentType="text/html; charset=euc-kr"%>
<%@ page import="java.io.File,java.util.Date,jxl.*,jxl.write.*"%>
<%
WritableWorkbook workbook = Workbook.createWorkbook(new File("E:/_Workspace/blr/blr/cms/excel/data/aaa.xls"));

WritableSheet sheet = workbook.createSheet("First Sheet", 0);
Label label = new Label(0,2,"A label record");
sheet.addCell(label);

// java.lang.Number 인지 jxl.write.Number  구분해야지^^

jxl.write.Number number = new jxl.write.Number(3,4,3.1415);
sheet.addCell(number);

workbook.write();
workbook.close();
%>

[POI로 테이블에 값넣기] poi.jsp참조

/***************************************************************************************/

엑셀파일처리 POI,JXL비교해 보았습니다.

10000번 for문을 돌려 첫번째 칼럼에 데이타를 입력하였습니다.

이걸 10번 반복한 체크시간입니다.

측정시간단위(밀리세컨)
D:\>java writeTest
============= jxl write time =============
0=>write time::719
1=>write time::281
2=>write time::250
3=>write time::266
4=>write time::234
5=>write time::266
6=>write time::234
7=>write time::266
8=>write time::234
9=>write time::329
=============      end      =============
============= poi write time =============
0=>write time::1110
1=>write time::922
2=>write time::1031
3=>write time::734
4=>write time::1328
5=>write time::766
6=>write time::797
7=>write time::1515
8=>write time::1719
9=>write time::2890
=============      end      =============

거의 2~3배 가까이 시간의 차이가 있더군여.. 단순히 엑셀파일만 다룬다면
jxl패키지를 사용하시는게 훨씬 좋을듯 합니다.

jxl_read.java

jxl_write.java

안녕하세요. Sharing Java 운영자 아기팬더 입니다. 자바를 이용하여 엑셀을 다루는 방법이 여러가지 있습니다.

관심이 많아서 네이버를 통해서 학습을 하고자 했는데 일관된 예제들과 생각보다는 부족한 설명으로 인해 많은 이해하기 위해

많은 시간을 보낸 것 같습니다. 개인적으로 공부차원에서 오늘 맘잡고 정리하여 공유합니다. 주석을 완전히 달면서 API 문서를

보려고 하니 생각보다 시간이 많이 걸리더군요. 이클립스를 주로 다루기 때문에 코딩하고 실행하였을 때 이클립스 상에서는

오류가 없었습니다. 혹시라도 실행이 안 되면 답글 달아주시면 바로 수정하겠습니다.

저는 jxl api를 이용하여 정리하였습니다. 참고 바랍니다.

1. 준비사항

    당연히 이클립스를 사용하신다면 jxl api(링크주소) 중에서 jexcelapi_2_6_4.zip 를 다운 받아서 사용하시는 프로젝트 파일

    주변에 압축을 풀어주세요.

    이클립스 메뉴바에서 현재의 프로젝트명을 오른쪽 클릭 - Build Path - Add External Archives 클릭한 후
    jxl API를 다운받아서 압축을 푼 곳에서 jxl.jar 파일을 찾아서 삽입시켜야 해요.

    배포를 고려한다면 엄한 곳에서 가져오지는 마세요^^

2. 실전

    jxl api 폴더 내의 doc폴더 안을 보시면 java api와 똑 같은 형태의 api문서를 확인하실 수 있습니다. 너무 자세하죠 ?

    이제부터 주석을 꼼꼼히 보시면서 실행해 보시면 기분이 좋아지실 겁니다. ^^

3. Jxl_Write.java (엑셀 파일을 생성하는 부분)

//babypanda(2007.07.24)

import java.io.File; // 파일 생성을 위해서 필요
import java.io.FileNotFoundException; // 파일 생성을 위해서 필요
import java.io.IOException; // 파일 생성을 위해서 필요

// 아래의 jxl 부분을 이클립스에서 사용하시기 위해서는 메뉴바에서 현재의 프로젝트명을 오른쪽 클릭 - Build Path - Add External

    Archives 클릭한 후
// jxl API를 다운받아서 압축을 푼 곳에서 jxl.jar 파일을 찾아서 삽입시켜야 해요. 꼭.... 반드시.... 무조건....
// 배포를 고려한다면 엄한 곳에서 가져오지는 마셈. 가까운 곳에 압축을 풀어서 불러오셈. ^^

import jxl.Workbook; // 엑셀 파일 관리를 위해 처음과 끝에 해당하는 기본이 되는 추상 클래스

import jxl.write.WritableWorkbook; // 실제 엑셀 파일 관리를 위해 Workbook, Sheet을 생성하는 Swing의 Frame과 같은 사막의 오아시스 역할하는 추상 클래스
import jxl.write.WritableSheet; // 쉬트를 관리하는 인터페이스
import jxl.write.WritableCellFormat; // 셀의 포멧 관련 클래스
import jxl.write.WriteException; // 셀의 쓰기 오류를 관리하기 위한
import jxl.write.Label; // 라벨 관리 클래스
//import jxl.write.Blank; // 빈셀 관리 클래스

import jxl.format.*; // 셀 정렬, 보더, 컬러 부분 관련 클래스 임포트

public class Jxl_Write{

     public static void  main(String args[]) throws FileNotFoundException, IOException, WriteException{
     // 예외처리를 아예 해주고 내려옵니다.
 
     WritableWorkbook myWorkbook = Workbook.createWorkbook(new File("jxl_Smile.xls")); // 파일이름을 정하여 생성한다.

     WritableSheet mySheet = myWorkbook.createSheet("first sheet", 0); // WritableSheet는 인터페이스
     // WritableWorkbook에서 메소드를 이용하여 생성. 0번, 즉 첫번째 쉬트를 first sheet라는 이름으로 생성한다.

     WritableCellFormat numberFormat = new WritableCellFormat(); // 번호 셀 포멧 생성
     WritableCellFormat nameFormat = new WritableCellFormat(); // 이름 셀 포멧 생성
     WritableCellFormat dataFormat = new WritableCellFormat(); // 데이터 셀 포멧 생성

     // 번호 레이블 셀 포멧 구성(자세한 것은 링크 된 API를 참조하셈) 참고사항 : 여기 부분에서 WriteException이 발생하네요.
     // 그러나 상단에서 미리 예외 처리를 해서 상관 없겠네요.

     numberFormat.setAlignment(Alignment.CENTRE); // 셀 가운데 정렬
     numberFormat.setVerticalAlignment(VerticalAlignment.CENTRE); // 셀 수직 가운데 정렬
     numberFormat.setBorder(Border.ALL, BorderLineStyle.THICK); // 보더와 보더라인스타일 설정
     numberFormat.setBackground(Colour.ICE_BLUE); // 여름에 맞는 색깔 ? ^^
 
     // 이름 레이블 셀 포멧 구성(자세한 것은 링크 된 API를 참조하셈)
     nameFormat.setAlignment(Alignment.CENTRE); // 셀 가운데 정렬
     nameFormat.setVerticalAlignment(VerticalAlignment.CENTRE); // 셀 수직 가운데 정렬
     nameFormat.setBorder(Border.BOTTOM, BorderLineStyle.HAIR); // 보더와 보더라인스타일 설정
     nameFormat.setBackground(Colour.GOLD); // 여름에 맞는 색깔 두번째 ? ^^

     // 데이터 셀 포멧 구성
     dataFormat.setAlignment(Alignment.CENTRE); // 셀 가운데 정렬
     dataFormat.setVerticalAlignment(VerticalAlignment.CENTRE); // 셀 수직 가운데 정렬

     // 쉬트의 컬럼 넓이 설정

     mySheet.setColumnView(0, 8); // 쉬트의 번호 컬럼(0번째)의 넓이 설정. setCloumnView(몇번째 컬럼, 넓이)
     mySheet.setColumnView(1, 15); // 쉬트의 이름 컬럼(1번째)의 넓이 설정
     mySheet.setColumnView(2, 20); // 쉬트의 비고 컬럼(2번째)의 넓이 설정

     // 라벨을 이용하여 해당 셀에 정보 넣기 시작

     Label numberLabel = new Label(0, 0, "학번", numberFormat); // 학번 라벨(열,행,"문장",포멧)
     mySheet.addCell(numberLabel); // 쉬트의 addCell 메소드를 사용하여 삽입

     Label nameLabel = new Label(1, 0, "성명", nameFormat); // 성명 라벨(열,행,"문장",포멧)
     mySheet.addCell(nameLabel); // 쉬트의 addCell 메소드를 사용하여 삽입

     //Blank blank = new Blank(2, 0, numberFormat); // 빈 셀(열,행,포멧) -- 필요 시 주석 처리 풀고 사용하셈. ^^
     //sheet.addCell(blank);

     Label postScript = new Label(2, 0, "비고", nameFormat); // 비고 라벨(열,행,"문장",포멧)
     mySheet.addCell(postScript); // 쉬트의 addCell 메소드를 사용하여 삽입

       for(int no=1; no<6; no++){
          Label numberLabels = new Label(0, no, "["+no+"]", dataFormat); // 데이터 포멧에 맞게 1에서 5까지 번호 생성
          mySheet.addCell(numberLabels); // 셀에 삽입
       
          Label nameLabels =new Label(1, no, (char)(no+64)+"", dataFormat); // 데이터 포멧에 맞게 대문자 A에서 E까지 생성
          mySheet.addCell(nameLabels); // 셀에 삽입
      }

     // 라벨을 이용하여 해당 셀에 정보 넣기 끝

     myWorkbook.write(); // 준비된 정보를 엑셀 포멧에 맞게 작성
     myWorkbook.close(); // 처리 후 메모리에서 해제 처리
     }
}

4. Jxl_Read.java (엑셀파일을 읽어오는 부분)

//babypanda(2007.07.24)

import java.io.*; // 파일 입력 관련 클래스
import jxl.*; // jxl 관련 클래스

public class Jxl_Read{
     public static void  main(String args[]) throws FileNotFoundException, IOException,jxl.read.biff.BiffException{
    // 이번에도 파일과 엑셀 파일 입력 관련 예외 선언을 미리 해주고 들어옵니다.

     Workbook myWorkbook = Workbook.getWorkbook(new File("jxl_Smile.xls")); // 파일을 읽어 와서...
     Sheet mySheet = myWorkbook.getSheet(0); // 정확한 쉬트를 입력 받아서...
 
     System.out.print("학번\t성명\t비고\t\n"); // 엑셀 제목을 적어 주고
 
          for(int no=1;no<6;no++){ // 행의 갯수 만큼 돌리고
               for(int i=0;i<3;i++){ // 열의 갯수 만큼 돌려서
                        Cell myCell = mySheet.getCell(i,no); // 셀의 행과 열의 정보를 가져온 후...
                        System.out.print(myCell.getContents()+"\t"); // 텝의 거리 만큼 열을 나열 하고...
          //getContents()메소드에 대해

          //Quick and dirty function to return the contents of this cell as a string. 이라고 API에 쓰여 있더군요.
               }
            System.out.println(); // 행이 바뀔 때 마다 개행하여 출력해 보셈.
          }
     }
}

5. 실행화면

1) 엑셀에 쓰기

We suggest the following mirror site for your download:

http://ftp.kaist.ac.kr/pub/Apache/

Other mirror sites are suggested below. Please use the backup mirrors only to download PGP and MD5 signatures to verify your downloads or if no other mirrors are working.

HTTP