jQuery 입문 | Ajax 사용 | Ajax 메소드 $.ajax() $.get() .load()

Ajax 메소드

$.ajax() 메소드

jQuery는 Ajax와 관련된 다양하고 편리한 많은 메소드를 제공한다.

그중에서도 $.ajax() 메소드는 모든 jQuery Ajax 메소드의 핵심이 되는 통합적인 메소드이다 .
$.ajax() 메소드는 HTTP 요청을 만드는 강력하고도 직관적인 방법을 제공한다.

형식

jQuery.ajax( url [, settings] ) >> 1.5 이상버젼
jQuery.ajax( settings )  >> 1.0 이상버젼

• url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
• settings : key/value 쌍으로 된 Ajax 요청 Set ( optional )
  • url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
  • data : 요청과 함께 서버에 보내는 string 또는 json
  • success(data, textStatus, jqXHR) : 요청이 성공일때 실행되는 callback 함수
  • dataType : 서버에서 내려온 data 형식. ( default : xml, json, script, text, html )

메소드 체이닝(method chaining)

예제

다음 예제는 $.ajax() 메소드에서 사용할 수 있는 대표적인 옵션을 설명한다.

$.ajax({
    url: "/rest/1/pages/245", // 클라이언트가 HTTP 요청을 보낼 서버의 URL 주소
    data: { name: "홍길동" },  // HTTP 요청과 함께 서버로 보낼 데이터
    method: "GET",   // HTTP 요청 메소드(GET, POST 등)
    dataType: "json" // 서버에서 보내줄 데이터의 타입
})
// HTTP 요청이 성공하면 요청한 데이터가 done() 메소드로 전달됨.
.done(function(json) {
    $("<h1>").text(json.title).appendTo("body");
    $("<div class=\"content\">").html(json.html).appendTo("body");
})
// HTTP 요청이 실패하면 오류와 상태에 관한 정보가 fail() 메소드로 전달됨.
.fail(function(xhr, status, errorThrown) {
    $("#text").html("오류가 발생했다.<br>")
    .append("오류명: " + errorThrown + "<br>")
    .append("상태: " + status);
})
// 
.always(function(xhr, status) {
    $("#text").html("요청이 완료되었습니다!");
});

다음 예제는 $.ajax() 메소드의 동작을 보여주는 간단한 예제이다.

var jqxhr = $.ajax("/rest/1/pages/245")
.done(function() {
  alert("성공");
})
.fail(function() {
  alert("실패");
 })
.always(function() {
  alert("완료");
});
      
jqxhr.always(function() {
  alert("두번째 성공");
});

코드 실행

$.ajaxSetup() 메소드

공통적인 기본 ajax 요청을 미리 설정하는데 사용한다.

형식

jQuery.ajaxSetup( options )

• optional : default Ajax 요청의 설정값 ( key/value )

예제

아래 예제는 미리 $.ajaxSetup()에 기본사항들을 설정한 후 ajax 로 각각 호출한다.

$.ajaxSetup({  
  url: '/api/users',  
  global: false,   
  type: "POST"     
});  

$.ajax({  
  // url not set here; uses '/api/users'  
  data: {'name': 'Dan'}  
});

$.ajax({  
  // url not set here; uses '/api/users'  
  data: {'name': 'John'}  
}); 

$.get() 메소드

jQuery에서는 Ajax를 이용하여 GET 방식의 HTTP 요청을 구현한 $.get() 메소드를 제공한다.
이 메소드를 사용하면 서버에 GET 방식의 HTTP 요청을 보낼 수 있다.

형식

jQuery.get(  url [, data] [, success(data, textStatus, jqXHR)] [, dataType] )

• url : 요청 URL (클라이언트가 HTTP 요청을 보낼 서버의 주소)
• data : 요청과 함께 서버에 보내는 string 또는 map
• success(data,textStatus,jqXHR) : 요청이 성공일때 실행되는 callback 함수
• dataType : 서버에서 내려온 data 형식. ( default : xml,json,script,text,html )

$.ajax으로 표현

$.ajax({
  type: "GET",
  url: url,  
  data: data,  
  success: success,  
  dataType: dataType  
});  

다음 예제는 $.get() 메소드의 동작을 보여주는 간단한 예제이다.

// GET 방식으로 서버에 HTTP Request를 보냄.
$.get("/examples/media/request_ajax.php",
  { species: "고양이", name: "나비", age: 3, }, // 서버가 필요한 정보를 같이 보냄.
    function(data, status) {
      $("#text").html(data + "<br>" + status); // 전송받은 데이터와 전송 성공 여부를 보여줌.
    }
   );
});

$.post() 메소드

jQuery에서는 Ajax를 이용하여 POST 방식의 HTTP 요청을 구현한 $.post() 메소드를 제공한다.
이 메소드를 사용하면 서버에 POST 방식의 HTTP 요청을 보낼 수 있다.

형식

$.post() 메소드의 원형은 다음과 같다.

$.post(URL주소[,데이터][,콜백함수]);

• URL 주소 : 클라이언트가 HTTP 요청을 보낼 서버의 주소이다.
• 데이터 : HTTP 요청과 함께 서버로 보낼 데이터를 전달한다.
• 콜백 함수 : HTTP 요청이 성공했을 때 실행할 함수를 정의한다.

$.ajax으로 표현

$.ajax({
  type: "POST",
  url: url,  
  data: data,  
  success: success,  
  dataType: dataType  
});  

예제

다음 예제는 $.post() 메소드의 동작을 보여주는 간단한 예제이다.

// POST 방식으로 서버에 HTTP Request를 보냄.
$.post("/examples/media/request_ajax.php",
  { name: "홍길동", grade: "A" },              // 서버가 필요한 정보를 같이 보냄.
  function(data, status) {
    $("#text").html(data + "<br>" + status); // 전송받은 데이터와 전송 성공 여부를 보여줌.
  }
);

$.getJSON() 메소드

서버에 데이터를 HTTP GET 방식으로 전송한 후 서버측 응답을 JSON 형식으로 받을때 사용한다.

형식

jQuery.getJSON( url [, data] [, success(data, textStatus, jqXHR)] )

• url : 요청 Url
• data : 요청과 함께 서버에 보내는 string 또는 map
• success(data,textStatus,jqXHR) : 요청이 성공일때 실행되는 callback 함수

$.ajax 로 표현

$.ajax({  
  url: url,  
  dataType: 'json',  
  data: data,  
  success: callback  
});  

예제

$.getJSON("example?foo=1",   
    {   
        tags: "mount rainier",   
        tagmode: "any",   
        format: "json"   
    },   
    function(data) {   
        $.each(data.items, function(i,item) {   
          $("<img/>").attr("src", item.media.m).appendTo("#images");   
          if ( i == 3 )
		      return false;   
        });   
    }); 

.load() 메소드

load() 메소드는 선택한 요소에서 호출하는 유일한 jQuery Ajax 메소드이다.

load() 메소드는 서버에서 데이터를 읽은 후, 읽어 들인 HTML 코드를 선택한 요소에 표시한다.
또한, 선택자를 URL 주소와 함께 전송하면, 읽어 들인 HTML 코드 중에서 선택자와 일치하는 요소만을 배치한다.

형식

.load( url [, data] [, complete(responseText, textStatus, XMLHttpRequest)] )

• url : 요청 URL
• data : 요청과 함께 서버에 보내는 string 또는 map
• complete(responseText, textStatus, XMLHttpRequest) : 요청이 완료될때 실행되는 callback 함수

예제

다음 예제들 .load() 메소드의 다양한 형태를 보여주는 간단한 예제이다.

//  Html Content 로딩  
$('#result').load('ajax/test.html');  
  
//  Html Content 로딩 후 메시지  
$('#result').load('ajax/test.html', function() {  
  alert('Load was performed.');  
});  
  
//  Html Content #container Target 로딩  
$('#result').load('ajax/test.html #container');  
  
//  array parameter 전달 후 Html Content 로딩  
$("#objectID").load("test.asp", { 'choices[]': ["Jon", "Susan"] } );  

다음 예제는 .load() 메소드의 동작을 보여주는 간단한 예제이다.

$(function() {
    $("#btnRequest").on("click", function() {
        // URL 주소에 존재하는 HTML 코드에서 <li>요소를 읽은 후에 id가 "list"인 요소에 배치한다.
        $("#list").load("/examples.html li");
    });
});

참조

• https://api.jquery.com/jQuery.Ajax/
• https://api.jquery.com/jQuery.ajaxSetup/