jQuery.ajax(options)

jQuery.ajax(options)

 

1. 파라미터

  - options : key/value 쌍으로 이루어진다. 모든 option의 값들은 생략 가능하며, $.ajaxSetup()의 형태로 default 값을 만들어서

                  사용이 가능하다. 아래는 option을 구성하는 값에 대한 설명이다.

       * asyn(Boolean)

            : 모든 request는 기본적으로 비동기 방식이다. 만약 동기 방식을 원한다면, asyn:false의 형식으로 구성하면 된다.

              동기방식의 request인 경우, 응답을 받는 동안 화면이 멈추는 현상과 화면에서 다른 조작을 취할 수 없다.

       * beforeSend(Function)

            : request를 보내기 전에 XMLHttpRequest값의 변경을 가능하게 하는 callback function.XMLHttpRequest는

              beforeSend() function의 입력 값 형태로 사용이 된다. Ajax.Event에서 상세한 내용을 다룬다.

       * cache(Boolean)

            : jQuery 1.2에서 추가되었으며, false일 경우 요청 내용이 화면에 바로 반영되며, true일 경우 browser에 의해 저장된다.

       * complete(Function)

            : 요청이 완료되었을 경우 호출된다.(complete가 호출된 이후에 success 또는 error function이 호출된다. complete가

              XMLHttpRequest 객체와 요청에 대한 성공 여부의 문자열 형식의 값을 입력 값으로 받는다.)

       * contentType(String)

            : 서버로 보내지는 데이터의 content-type. 서버로 전송되는 data는 일정한 형식으로 인코딩되며,

              "application/x-wwwform-urlencoded"는 URL 인코딩이라고 부르며, 별도의 설정을 하지 않은 경우 기본 값으로

              URL 인코딩을 사용한다. URL 인코딩 방식은 대량의 data나 이미지, 파일 등과 같은 바이너리 형식의 data를 전송

              하기에 적합하지 않다. 이런 경우 "multipart/form"와 같은 contentType을 사용한다.

       * data(Object|String)

            : 서버로 보내지는 데이터를 의미하며, 입력 받은 문자열이 &name=value 형식의 값이 아닐 경우 자동변환한다.

              입력 값 중 문자열을 제외한 객체 형식의 입력 값은 key/value 쌍의 값 형태로 되어 있어야 하며, 값이 Array 형태일

              경우 jQuery는 같은 key로 서로 다른 값을 갖게 된다.

       * dataType(String)

            : request에 대한 응답 결과의 형태. dataType:none의 형태로 설정할 경우 XML과 HTTP 형태 중 jQuery가 적합하다고

              판단하는 형식으로 data-type을 정의한다. XML 형식일 경우 responseXML, TEXT 형식일 경우 responseHTTP

              형식으로 변환해서 success() function의 입력 값이 전달된다. success() callback function의 첫 번째 입력 값의

              형태는 다음과 같다.

              (xml, html, script, json, jsonp, text)

       * error(Function)

            : 요청이 실패한 경우 호출된다. error() function은 XMLHttpRequest 객체, error가 발생한 원인에 대한 설명(문자열

              형태) 그리고 exception 객체로 구성되는 3개의 입력 값을 받는다.

       * global(Boolean)

            : ajaxStart() 또는 ajaxStop()등 Ajax를 trigger 할 수 있는 option을 제공한다.

              global:false의 형식으로 설정될 경우 tigger를 못하도록 막는다.

       * ifModified(Boolean)

            : 현재의 응답이 이전의 응답 결과와 다를 경우만 처리하도록 한다. 헤더값에 존재하는 "if-Modified-Since"의 값으로

              처리하며 기본 값은 헤더의 값을 체크하지 않는 false 이다.

       * jsonp(String)

            : jsonp요청에 대한 callback function을 override한다. GET, POST방식에서 value 값이 callback일 경우

              "callback=""로 사용된다. 따라서 {jsonp:'onJsonPLoad'}일 경우 'onJsonPLoad=?'의 형식으로 서버로 보내진다.

       * processData(Boolean)

            : data:{key:"value"}의 형식에서 {key:"value"}의 값들을 query String형식인 &key=value의 형식으로 변경한다.

              DOM Document 형식 또는 query string이 아닌 다른 형태를 원할 경우 processData:false로 설정한다.

       * success(Function)

            : 요청이 성공했을 경우 호출된다. 2개의 입력 값을 받으며, 첫 번째 입력 값은 서버로부터 받은 결과이고 형태는

              'dataType'에서 정의된 형태로 전달되고, 두 번째 입력 값은 상태에 대한 문자열 형식으로 입력된다.

       * timeOut(Number)

            : 요청에 대한 응답 제한 시간을 ms(millisecond)의 단위로 설정한다. $ajaxSetup에서 설정한 time-out 시간을

              override한다. 한 예로 $ajaxSetup에서 정의한 time-out 시간보다 많은 시간이 필요한 페이지에서 적용할 수 있다.

       * url(String)

            : 요청을 보낼 서버의 URL

[출처] jQuery Ajax - jQuery.ajax(options) (System.out.println("Web Developer");) |작성자 돌

[출처] jQuery.ajax(options)|작성자 하루살이