Loại nội dung JSON chính xác là gì?

Tôi đã loay hoay với JSON một thời gian, chỉ đẩy nó ra dưới dạng văn bản và nó không làm tổn thương bất kỳ ai (mà tôi biết), nhưng tôi muốn bắt đầu làm mọi thứ đúng cách.

Tôi đã thấy như vậy nhiều "tiêu chuẩn" có mục đích cho loại nội dung JSON:

application/json
application/x-javascript
text/javascript
text/x-javascript
text/x-json

Nhưng cái nào đúng, hay nhất? Tôi tập hợp rằng có những vấn đề hỗ trợ trình duyệt và bảo mật khác nhau giữa chúng.

Tôi biết có một câu hỏi tương tự, Loại MIME nào nếu JSON được trả về bởi API REST? , nhưng tôi muốn một câu trả lời được nhắm mục tiêu hơn một chút.

Đối với văn bản JSON:

application/json

Loại phương tiện MIME cho văn bản JSON là application/json. Mã hóa mặc định là UTF-8. (Nguồn: RFC 4627 ).

Đối với JSONP (javascript có thể chạy) với hàm gọi lại:

application/javascript

Dưới đây là một số bài viết trên blog đã được đề cập trong các ý kiến ​​có liên quan.

• Tại sao bạn không nên sử dụng text/htmlcho JSON
• Internet Explorer đôi khi có vấn đề với application/json
• Một danh sách khá đầy đủ về Mimetypes và những gì để sử dụng chúng cho
• Danh sách loại mime chính thức tại IANA từ câu trả lời của @ gnrfan bên dưới

IANA đã đăng ký Loại MIME chính thức cho JSON như application/json.

Khi được hỏi về lý do tại sao không text/json, Crockford dường như đã nói JSON không thực sự là JavaScript cũng không phải là văn bản và IANA cũng có nhiều khả năng ra tay application/*hơn text/*.

Nhiêu tai nguyên hơn:

• Các loại phương tiện truyền thông
• Yêu cầu cho ý kiến ​​4627
• bluesmoon: JSON có một loại

Đối với JSON:

Content-Type: application/json

Đối với JSON-P :

Content-Type: application/javascript

Tất nhiên, loại phương tiện MIME chính xác cho JSON là application/json , nhưng cần phải nhận ra loại dữ liệu nào được mong đợi trong ứng dụng của bạn.

Ví dụ, tôi sử dụng Ext GWT và phản hồi của máy chủ phải ở dạng văn bản / html nhưng chứa dữ liệu JSON.

Phía khách hàng, người nghe biểu mẫu Ext GWT

uploadForm.getForm().addListener(new FormListenerAdapter()
{
    @Override
    public void onActionFailed(Form form, int httpStatus, String responseText) 
    {
        MessageBox.alert("Error");
    }

    @Override
    public void onActionComplete(Form form, int httpStatus, String responseText) 
    {
        MessageBox.alert("Success");
    }
});

Trong trường hợp sử dụng dụng loại phản hồi ứng dụng / json , trình duyệt đề nghị tôi lưu tệp.

Đoạn mã nguồn phía máy chủ sử dụng Spring MVC

return new AbstractUrlBasedView() 
{
    @SuppressWarnings("unchecked")
    @Override
    protected void renderMergedOutputModel(Map model, HttpServletRequest request,
                                           HttpServletResponse response) throws Exception 
    {
        response.setContentType("text/html");
        response.getWriter().write(json);
    }
};

JSON:

Phản hồi là dữ liệu được tạo động, theo các tham số truy vấn được truyền trong URL.

Thí dụ:

{ "Name": "Foo", "Id": 1234, "Rank": 7 }

Loại nội dung: application/json

JSON-P:

JSON với phần đệm. Phản hồi là dữ liệu JSON, với một lệnh gọi hàm bao quanh nó.

Thí dụ:

functionCall({"Name": "Foo", "Id": 1234, "Rank": 7});

Loại nội dung: application/javascript

Nếu bạn đang sử dụng Ubuntu hoặc Debian và bạn phân phát các tệp .json thông qua Apache, bạn có thể muốn phân phát các tệp có loại nội dung chính xác. Tôi đang làm điều này chủ yếu vì tôi muốn sử dụng tiện ích mở rộng JSONView của Firefox

Mô-đun Apache mod_mime sẽ giúp thực hiện điều này một cách dễ dàng. Tuy nhiên, với Ubuntu, bạn cần chỉnh sửa tệp /etc/mime.types và thêm dòng

application/json json

Sau đó khởi động lại Apache:

sudo service apache2 restart

Nếu bạn đang gọi Dịch vụ web ASP.NET từ phía máy khách, bạn phải sử dụng application/jsonđể nó hoạt động. Tôi tin rằng điều này giống với các khung jQuery và Ext .

Loại nội dung phù hợp cho JSON là application/jsonKHÔNG GIỚI HẠN bạn đang sử dụng JSONP , còn được gọi là JSON với Padding, thực chất là JavaScript và do đó, loại nội dung phù hợp sẽ là application/javascript.

Không có nghi ngờ gì, đó application/jsonlà loại MIME tốt nhất cho phản hồi JSON.

Nhưng tôi đã có một số kinh nghiệm mà tôi phải sử dụng application/x-javascriptvì một số vấn đề về nén. Môi trường lưu trữ của tôi được chia sẻ lưu trữ với GoDaddy . Họ không cho phép tôi thay đổi cấu hình máy chủ. Tôi đã thêm đoạn mã sau vào web.configtập tin của mình để nén phản hồi.

<httpCompression>
    <scheme name="gzip" dll="%Windir%\system32\inetsrv\gzip.dll"/>
    <dynamicTypes>
        <add mimeType="text/*" enabled="true"/>
        <add mimeType="message/*" enabled="true"/>
        <add mimeType="application/javascript" enabled="true"/>
        <add mimeType="*/*" enabled="false"/>
    </dynamicTypes>
    <staticTypes>
        <add mimeType="text/*" enabled="true"/>
        <add mimeType="message/*" enabled="true"/>
        <add mimeType="application/javascript" enabled="true"/>
        <add mimeType="*/*" enabled="false"/>
    </staticTypes>
</httpCompression>
<urlCompression doStaticCompression="true" doDynamicCompression="true"/>

Bằng cách sử dụng này, các trang .aspx đã được nén bằng g-zip nhưng các phản hồi JSON thì không. Tôi đã thêm

<add mimeType="application/json" enabled="true"/>

trong phần loại tĩnh và động. Nhưng điều này hoàn toàn không nén các phản hồi JSON.

Sau đó tôi loại bỏ loại mới được thêm này và thêm

<add mimeType="application/x-javascript" enabled="true"/>

trong cả phần loại tĩnh và loại động và đã thay đổi loại phản hồi trong

.ashx (trình xử lý không đồng bộ) để

application/x-javascript

Và bây giờ tôi thấy rằng các phản hồi JSON của tôi đã được nén bằng g-zip. Vì vậy, cá nhân tôi khuyên bạn nên sử dụng

application/x-javascript

chỉ khi bạn muốn nén các phản hồi JSON của mình trên môi trường lưu trữ được chia sẻ . Bởi vì trong lưu trữ được chia sẻ, chúng không cho phép bạn thay đổi cấu hình IIS .

Chỉ khi sử dụng application/jsonlàm loại MIME, tôi mới có các tính năng sau (kể từ tháng 11 năm 2011 với các phiên bản Chrome mới nhất, Firefox với Fireorms ):

• Không còn cảnh báo nào từ Chrome khi JSON được tải từ máy chủ.
• Fireorms sẽ thêm một tab vào phản hồi hiển thị cho bạn dữ liệu JSON được định dạng. Nếu loại MIME khác, nó sẽ chỉ hiển thị dưới dạng 'Nội dung phản hồi'.

Không phải tất cả mọi thứ hoạt động cho loại nội dung application/json.

Nếu bạn đang sử dụng Ext JS biểu mẫu gửi lên tệp tải lên, hãy lưu ý rằng phản hồi của máy chủ được trình duyệt phân tích cú pháp để tạo tài liệu cho <iframe>.

Nếu máy chủ đang sử dụng JSON để gửi đối tượng trả về, thì Content-Type tiêu đề phải được đặt thànhtext/html để báo cho trình duyệt chèn văn bản không thay đổi vào thân tài liệu.

Xem tài liệu API Ext JS 3.4.0 .

JSON là ngôn ngữ dành riêng cho tên miền (DSL) và định dạng dữ liệu độc lập với JavaScript và do đó có loại MIME riêng , application/json. Tất nhiên, việc tôn trọng các loại MIME được điều khiển bởi máy khách, do đó text/plaincó thể thực hiện chuyển byte, nhưng sau đó bạn sẽ đẩy mạnh việc giải thích sang miền ứng dụng của nhà cung cấp một cách không cần thiết - application/json. Bạn có chuyển XML qua khôngtext/plain không?

Nhưng thành thật mà nói, sự lựa chọn loại MIME của bạn là lời khuyên cho khách hàng về cách diễn giải dữ liệu - text/plainhoặctext/HTML (khi đó không phải là HTML) giống như kiểu xóa - nó không chính xác như làm cho tất cả các đối tượng thuộc loại Object của bạn bằng ngôn ngữ được nhập.

Không có thời gian chạy trình duyệt mà tôi biết sẽ lấy tài liệu JSON và tự động cung cấp nó cho thời gian chạy dưới dạng đối tượng có thể truy cập JavaScript mà không cần can thiệp, nhưng nếu bạn đang làm việc với máy khách bị tê liệt thì đó là một vấn đề hoàn toàn khác. Nhưng đó không phải là toàn bộ câu chuyện- Các dịch vụ JSON của RESTful thường không có thời gian chạy JavaScript, nhưng nó không ngăn họ sử dụng JSON làm định dạng trao đổi dữ liệu khả thi. Nếu các máy khách bị tê liệt ... thì tôi sẽ xem xét có thể tiêm HTML qua Ajax dịch vụ tạo khuôn mẫu thay thế.

Ứng dụng / JSON!

Nếu bạn đang ở trong môi trường phía máy khách, việc điều tra về hỗ trợ trình duyệt chéo là bắt buộc đối với một ứng dụng web được hỗ trợ tốt.

Kiểu nội dung HTTP phù hợp sẽ là application/json, vì những người khác cũng đã nêu bật, nhưng một số khách hàng không xử lý nó tốt, đó là lý do tại sao jQuery khuyến nghị mặc định text/html.

Đáp án đúng là:

Content-Type: application/json

Như nhiều người khác đã đề cập, application/json là câu trả lời chính xác.

Nhưng điều chưa được giải thích là những lựa chọn khác mà bạn đề xuất có ý nghĩa gì.

• application/x-javascript: Loại MIME thử nghiệm cho JavaScript trước đây application/javascriptđã được tạo chuẩn.

• text/javascript: Bây giờ đã lỗi thời. Bạn nên sử dụng application/javascriptkhi sử dụng javascript.

• text/x-javascript: Loại MIME thử nghiệm cho tình huống trên.

• text/x-json: Loại MIME thử nghiệm cho JSON trước khi application/jsonđược đăng ký chính thức.

Nói chung, bất cứ khi nào bạn có bất kỳ nghi ngờ nào về các loại nội dung, bạn nên kiểm tra liên kết này

Trong JSP , bạn có thể sử dụng điều này trong chỉ thị trang:

<%@ page language="java" contentType="application/json; charset=UTF-8"
    pageEncoding="UTF-8"%>

Loại phương tiện MIME chính xác cho JSON là application/json. JSP sẽ sử dụng nó để gửi phản hồi cho khách hàng.

“ application/json” Là đúng JSON loại nội dung.

def ajaxFindSystems = {
  def result = Systems.list()
  render(contentType:'application/json') {
    results {
      result.each{sys->
        system(id:sys.id, name:sys.name)
      }
    }
    resultset (rows:result.size())
  }
}

Việc đăng ký IANA choapplication/json biết

Các ứng dụng sử dụng loại phương tiện này: JSON đã được sử dụng để trao đổi dữ liệu giữa các ứng dụng được viết bằng tất cả các ngôn ngữ lập trình sau: ActionScript, C, C #, Clojure, ColdFusion, Common Lisp, E, Erlang, Go, Java, JavaScript, Lua, Objective CAML, Perl, PHP, Python, Rebol, Ruby, Scala và Scheme.

Bạn sẽ nhận thấy rằng IANA.org không liệt kê bất kỳ loại phương tiện nào khác , trên thực tế thậm chí application/javascripthiện đã lỗi thời. Vì vậy, application/jsonthực sự là chỉ có thể đúng câu trả lời .

Hỗ trợ trình duyệt là một điều khác.

Các loại phương tiện truyền thông phi tiêu chuẩn được hỗ trợ rộng rãi nhất là text/jsonhoặc text/javascript. Nhưng một số tên tuổi lớn thậm chí sử dụng text/plain.

Điều kỳ lạ hơn nữa là tiêu đề Kiểu nội dung được gửi bởi Flickr, người trả về JSON dưới dạng text/xml. Google sử dụng text/javascriptcho một số apis ajax.

Ví dụ:

curl -I "https://ajax.googleapis.com/ajax/services/search/video?v=1.0&q=jsonexample"

Đầu ra: Content-Type: text/javascript

curl -I "https://www.flickr.com/services/rest/?method=flickr.test.echo&format=json&api_key=f82254c1491d894f1204d8408f645a93"

Đầu ra: Content-Type: text/xml

Loại MIME đúng là application/json

NHƯNG

Tôi đã trải qua nhiều tình huống mà loại trình duyệt hoặc người dùng khung cần thiết:

text/html

application/javascript

Tôi sử dụng dưới đây

contentType: 'application/json',
data: JSON.stringify(SendData),

Các Content-Gõ tiêu đề phải được thiết lập để ' application / json ' khi gửi bài. Máy chủ lắng nghe yêu cầu nên bao gồm " Chấp nhận = ứng dụng / json ". Trong Spring MVC bạn có thể làm như thế này:

@RequestMapping(value="location", method = RequestMethod.POST, headers = "Accept=application/json")

Thêm tiêu đề để trả lời:

HttpHeaders headers = new HttpHeaders();
headers.add("Content-Type", "application/json");

Trong Spring bạn có một loại được xác định: MediaType.APPLICATION_JSON_VALUEtương đương với application / json .

Các application/jsoncông trình tuyệt vời trong PHP để lưu trữ một mảng hoặc dữ liệu đối tượng.

Tôi sử dụng mã này để đưa dữ liệu vào JSON trên Google Cloud Storage (GCS) được đặt công khai có thể xem được :

$context = stream_context_create([
    'gs' => [
        'acl'=>'public-read', 
        'Content-Type' => 'application/json',
    ]
]);

file_put_contents(
    "gs://BUCKETNAME/FILENAME.json", 
    json_encode((object) $array), 
    false, 
    $context
);

Để lấy lại dữ liệu là thẳng về phía trước:

$data = json_decode(file_get_contents("gs://BUCKETNAME/FILENAME.json"));

Nếu JSON là với phần đệm thì nó sẽ như vậy application/jsonp. Nếu JSON không có phần đệm thì nó sẽ như vậy application/json.

Để đối phó với cả hai, đó là một cách thực hành tốt để sử dụng: 'application / javascript' mà không bận tâm đến việc đó là với phần đệm hay không có phần đệm.

Đối với JSON, tôi đang sử dụng:

 Content-Type: application/json

Điều này được mô tả trong đề xuất 7158 Định dạng trao đổi dữ liệu JSON của IETF, Phần 1.2: Thông số kỹ thuật của JSON .

Mở rộng các phản hồi được chấp nhận, khi bạn đang sử dụng JSON trong ngữ cảnh REST ...

Có một lập luận mạnh mẽ về việc sử dụng application/x-resource+jsonvà application/x-collection+jsonkhi bạn đại diện cho các tài nguyên và bộ sưu tập REST.

Và nếu bạn quyết định làm theo đặc tả jsonapi , bạn nên sử dụng application/vnd.api+json, vì nó được ghi lại.

Rõ ràng không có một tiêu chuẩn chung, rõ ràng là ngữ nghĩa được thêm vào các tài nguyên được chuyển giao biện minh cho Loại Nội dung rõ ràng hơn là chỉapplication/json .

Theo lý do này, các bối cảnh khác có thể biện minh cho Loại Nội dung cụ thể hơn .

Các nhà phát triển PHP sử dụng điều này:

<?php
    header("Content-type: application/json");

    // Do something here...
?>

Nếu bạn nhận được dữ liệu từ API REST trong JSON, do đó bạn phải sử dụng loại nội dung

For JSON data: Content-Type:application/json
For HTML data: Content-Type:text/html,
For XHTML data: Content-Type:application/xhtml+xml,
For XML data: Content-Type:text/xml, application/xml

Content-Type: application/json- json
Content-Type: application/javascript- json-P
Content-Type: application/x-javascript- javascript
Content-Type: text/javascript- javascript NHƯNG đã lỗi thời, các phiên bản IE cũ hơn được sử dụng làm thuộc tính html.
Content-Type: text/x-javascript- Các loại phương tiện JavaScript NHƯNG lỗi thời
Content-Type: text/x-json- json trước khi ứng dụng / json được đăng ký chính thức.

Các định dạng JSON (Ký hiệu đối tượng JavaScript) và JSONP ("JSON với phần đệm") dường như rất giống nhau và do đó có thể rất khó hiểu loại MIME nào họ nên sử dụng. Mặc dù các định dạng tương tự nhau, có một số khác biệt tinh tế giữa chúng.

Vì vậy, bất cứ khi nào trong bất kỳ nghi ngờ nào, tôi có một cách tiếp cận rất đơn giản (hoạt động hoàn toàn tốt trong hầu hết các trường hợp), cụ thể là, đi và kiểm tra tài liệu RFC tương ứng.

JSON RFC 4627 (Loại phương tiện / ứng dụng json cho Ký hiệu đối tượng JavaScript (JSON)) là thông số kỹ thuật của định dạng JSON. Nó nói trong phần 6, loại phương tiện MIME cho văn bản JSON là

application/json.

JSONP JSONP ("JSON with padding") được xử lý theo cách khác với JSON, trong một trình duyệt. JSONP được coi là một tập lệnh JavaScript thông thường và do đó, nó nên sử dụng application/javascript,loại MIME chính thức hiện tại cho JavaScript. Tuy nhiên, trong nhiều trường hợp, text/javascriptloại MIME cũng sẽ hoạt động tốt.

Lưu ý rằng text/javascriptđã được đánh dấu là lỗi thời bởi tài liệu RFC 4329 (Loại phương tiện tập lệnh) và nên sử dụng application/javascriptloại thay thế. Tuy nhiên, vì lý do di sản, text/javascriptvẫn được sử dụng rộng rãi và nó có hỗ trợ nhiều trình duyệt (điều này không phải lúc nào cũng đúng với application/javascriptloại MIME, đặc biệt là với các trình duyệt cũ hơn).