Kiểm tra XML và lược đồ XSD
Dán XML vào trình XML validator này để kiểm tra XML xem tài liệu có đúng cú pháp hay không. Nếu có lỗi, bạn thấy dòng và cột của lỗi đầu tiên, giải thích bằng lời dễ hiểu. Thêm lược đồ XSD để kiểm tra cả cấu trúc, và tài liệu hợp lệ sẽ được trả lại ở dạng đã định dạng. Mọi thứ chạy ngay trên trình duyệt của bạn nên XML không bị tải lên.
Cách kiểm tra file XML
- Nhấn Dán XML để đọc nội dung clipboard vào ô XML, hoặc tự dán văn bản vào. Khi dán xong, tài liệu được kiểm tra ngay.
- Nhấn Kiểm tra để kiểm tra lại sau khi bạn sửa văn bản.
- Đọc kết quả bên dưới nút. Khung màu xanh nghĩa là tài liệu đúng cú pháp. Khung đỏ XML sai cú pháp hiển thị một lỗi.
- Với lỗi, khung cho biết dòng và cột, một đoạn của dòng đó kèm mũi tên dưới cột, và nút Xem trong trình soạn thảo. Trình soạn thảo cũng cuộn tới dòng đó.
- Hãy sửa lỗi đầu tiên rồi kiểm tra lại. Công cụ chỉ hiện lỗi đầu tiên và đó là chủ ý: các lỗi phía sau thường chỉ là hệ quả của nó, chẳng hạn thiếu thẻ đóng.
Cách duy nhất để đưa XML vào là dán, vì không có nút chọn tệp. Hãy mở tệp bằng bất kỳ trình soạn thảo văn bản nào, sao chép toàn bộ rồi dán vào ô.
XML đúng cú pháp nghĩa là gì
Lần kiểm tra đầu tiên chỉ xét cú pháp. Một tài liệu đúng cú pháp khi tuân theo các quy tắc sau:
- Có đúng một phần tử gốc chứa mọi thứ còn lại.
- Mỗi thẻ mở có một thẻ đóng tương ứng, đúng thứ tự, hoặc tự đóng như
<br/>. - Giá trị thuộc tính nằm trong dấu nháy, như
id="7", và một thuộc tính chỉ xuất hiện một lần trong mỗi thẻ. - Ký tự & hoặc < nguyên văn trong văn bản được viết là
&hoặc<. - Chú thích không chứa hai dấu gạch ngang liên tiếp, và phần CDATA được đóng bằng
]]>. - Tiền tố namespace như
xs:được khai báo bằngxmlns:xs="..."ngay trên thẻ đó hoặc thẻ cha.
Đúng cú pháp không đồng nghĩa với hợp lệ theo lược đồ. Hợp lệ theo lược đồ nghĩa là tài liệu còn tuân theo một lược đồ, và đó là việc của tùy chọn XSD bên dưới.
Sửa lỗi XML: những lỗi thường gặp
Mỗi lỗi được giải thích bằng một câu thay vì thông báo thô của trình phân tích. Đây là những lỗi bạn sẽ gặp nhiều nhất:
- Thẻ đóng không khớp với thẻ mở: thiếu thẻ đóng, viết sai hoặc sai thứ tự. Hãy đóng các thẻ theo thứ tự ngược với lúc mở.
- Tài liệu kết thúc trước khi một thẻ được đóng: thiếu thẻ đóng cuối cùng, hoặc đoạn đã dán bị cắt. Hãy thêm thẻ đóng còn thiếu hoặc dán toàn bộ tài liệu.
- Có nội dung phía sau phần tử gốc: một phần tử gốc thứ hai, hoặc văn bản sau phần tử gốc. Hãy bọc tất cả trong một phần tử cha duy nhất.
- Thực thể chưa được định nghĩa: thường là thực thể HTML như
hoặc một ký tự & đứng riêng. Hãy dùng hoặc viết&. - Giá trị thuộc tính phải nằm trong dấu nháy: đang viết
id=7thay vìid="7". Hãy thêm dấu nháy. - Một thuộc tính xuất hiện hai lần trong cùng một thẻ: hãy xóa một trong hai.
- Tiền tố được dùng nhưng chưa từng khai báo: thiếu
xmlns:tiềntố. Hãy thêm khai báo vào thẻ đó hoặc thẻ cha. - Khai báo
<?xml ...?>chỉ được đặt ở ngay đầu: phía trước có dòng trống, khoảng trắng hoặc chú thích. Hãy xóa mọi thứ đứng trước. - Chú thích chứa hai dấu gạch ngang liên tiếp: hãy viết lại chú thích.
- Phần CDATA chưa được đóng: thiếu
]]>. Hãy thêm vào.
Các ký tự XML cấm, như ký tự điều khiển lạc chỗ, cũng được báo, cùng với thẻ mở không bao giờ kết thúc và chú thích không bao giờ đóng.
Validate XML với lược đồ XSD
Một tài liệu đúng cú pháp vẫn có thể sai so với mục đích: văn bản ở chỗ cần số, thiếu phần tử bắt buộc, hoặc phần tử nằm sai vị trí. Lược đồ mô tả những gì được phép, và công cụ có thể đối chiếu tài liệu với nó, giống một XSD validator.
- Nhấn nút bánh răng, Tùy chọn nâng cao.
- Dán lược đồ của bạn vào Lược đồ XSD (không bắt buộc). Để trống nếu bạn chỉ cần biết tài liệu có đúng cú pháp không.
- Dán XML vào ô XML rồi nhấn Kiểm tra.
Nếu XML không khớp, kết quả có tiêu đề «Không khớp với lược đồ» kèm số lỗi và liệt kê tối đa 100 lỗi. Mỗi mục cho XPath của phần tử, như /note/n[1], hoặc /note/@id với thuộc tính, rồi đến một câu rõ ràng và số dòng. Các câu đó gồm:
- giá trị sai kiểu, ví dụ văn bản ở chỗ cần
xs:int; - giá trị vi phạm một ràng buộc: mẫu, danh sách giá trị, độ dài, giá trị nhỏ nhất hoặc lớn nhất;
- phần tử con bắt buộc bị thiếu, hoặc phần tử không được mong đợi ở vị trí đó;
- thuộc tính không được phép, hoặc thuộc tính bắt buộc bị thiếu;
- phần tử gốc mà lược đồ không khai báo.
Khi vấn đề nằm ở lược đồ chứ không phải XML của bạn, nó có khung riêng: Lược đồ XSD không phải XML đúng cú pháp hoặc Không thể dùng lược đồ XSD này, và XML không được đối chiếu với nó. Lược đồ nhập hoặc bao gồm một tệp khác không dùng được, vì không có gì được tải về. Hãy đặt mọi định nghĩa vào một XSD duy nhất. Công cụ hỗ trợ XSD 1.0.
Định dạng XML online
Khi tài liệu hợp lệ, phần XML đã định dạng xuất hiện cùng nút Sao chép phía trên kết quả. Chọn độ rộng tại Thụt lề trong Tùy chọn nâng cao: 2 dấu cách, 4 dấu cách hoặc Tab. Kết quả cập nhật ngay. Việc định dạng theo xmllint --format nên dễ đoán:
- Phần thụt lề được áp dụng lại từ đầu, và văn bản chỉ gồm khoảng trắng giữa các thẻ bị bỏ.
- Văn bản bên trong một phần tử được giữ nguyên như bạn viết. Với nội dung hỗn hợp như
<p><b>a</b> <i>b</i></p>, khoảng trắng giữa các thẻ có thể mất. - Chú thích, phần CDATA và DOCTYPE được giữ lại.
- Khai báo XML được giữ y như bạn viết, và không được thêm nếu bạn không có.
Kết quả rất dài sẽ hiện bị cắt, kèm ghi chú cho biết đang hiện bao nhiêu dòng. Sao chép luôn lấy toàn bộ tài liệu.
Tệp XML lớn và những gì không được kiểm tra
Việc kiểm tra chạy trong một Web Worker ở nền. Tài liệu rất lớn chậm chủ yếu vì trình duyệt phải vẽ ngần ấy văn bản vào ô: khi thử nghiệm, một tài liệu 50 MB với hơn 600.000 dòng mất khoảng 30 giây từ lúc dán đến lúc có kết quả, còn tài liệu 20 MB mất khoảng 11 giây. Giới hạn là 120 triệu ký tự. Vượt quá, bạn sẽ được yêu cầu dán một đoạn nhỏ hơn.
Những gì không được kiểm tra: không có kiểm tra DTD, và thực thể cùng tệp bên ngoài không được tải vì không có gì được tải về. Chỉ hỗ trợ XSD 1.0. Bảng mã đã khai báo, như ISO-8859-1 hoặc UTF-16, bị bỏ qua vì văn bản đã dán vốn là Unicode. Tài liệu định nghĩa các thực thể bung ra thành quá nhiều văn bản sẽ bị từ chối, thẻ lồng nhau sâu hơn 2048 cấp cũng vậy.
Câu hỏi thường gặp
Làm sao để kiểm tra XML có đúng cú pháp không?
Dán XML vào ô "XML" rồi nhấn "Kiểm tra". Khung màu xanh nghĩa là mọi thẻ đều được đóng và lồng nhau đúng cách và tài liệu có một phần tử gốc. Khung đỏ "XML sai cú pháp" cho biết lỗi đầu tiên bằng lời dễ hiểu, kèm dòng và cột.
XML đúng cú pháp là gì?
Là XML tuân theo các quy tắc cú pháp: một phần tử gốc, mỗi thẻ mở được đóng bằng thẻ đóng đúng thứ tự, giá trị thuộc tính nằm trong dấu nháy, không lặp thuộc tính trong một thẻ và các ký tự đặc biệt như & được viết là &. Trình phân tích sẽ từ chối tài liệu vi phạm bất kỳ quy tắc nào trong số đó.
Đúng cú pháp và hợp lệ theo lược đồ khác nhau thế nào?
Đúng cú pháp nghĩa là cú pháp chính xác. Hợp lệ theo nghĩa chặt còn có nghĩa là tài liệu tuân theo một lược đồ (XSD hoặc DTD) quy định phần tử và giá trị nào được phép. Ở đây, khung xanh báo hợp lệ khi ô XSD trống chỉ có nghĩa là đúng cú pháp, còn khi bạn dán XSD thì nghĩa là đúng cú pháp và khớp lược đồ. Công cụ không hỗ trợ kiểm tra DTD.
Lỗi "opening and ending tag mismatch" trong XML nghĩa là gì?
Một thẻ đóng không khớp với thẻ đang mở tại điểm đó, tức là thiếu thẻ đóng, viết sai thẻ đóng hoặc hai thẻ chồng lên nhau. Công cụ này diễn đạt như sau: Thẻ đóng không khớp với thẻ mở ở dòng 1. Hãy sửa lỗi đầu tiên được nêu rồi kiểm tra lại, vì các lỗi sau thường chỉ là hệ quả của nó.
Vì sao XML báo "extra content at the end of the document"?
Có thứ gì đó nằm sau phần tử gốc, thường nhất là một phần tử gốc thứ hai, chẳng hạn hai bản ghi được dán nối tiếp nhau. Tài liệu XML chỉ có đúng một phần tử gốc. Hãy bọc các bản ghi trong một phần tử cha duy nhất, hoặc dán từng bản ghi một.
Vì sao XML báo thực thể nbsp chưa được định nghĩa?
là một thực thể HTML. XML chỉ định nghĩa sẵn <, >, &, " và '. Hãy dùng tham chiếu ký tự cho khoảng trắng không ngắt dòng, gõ trực tiếp ký tự đó, hoặc khai báo thực thể trong DTD. Ký tự & đứng riêng không mở đầu thực thể phải được viết là &.
Lỗi "XML declaration allowed only at the start of the document" nghĩa là gì?
Khai báo <?xml ...?> chỉ được đặt ở ngay đầu tài liệu, không có gì đứng trước. Thường là có dòng trống, khoảng trắng hoặc chú thích ở phía trước. Hãy xóa mọi thứ đứng trước khai báo và lỗi sẽ biến mất.
XML của tôi có bị tải lên khi kiểm tra không?
Không. Việc kiểm tra chạy ngay trên trình duyệt, trên thiết bị của bạn, và không có gì được tải lên hoặc lưu lại. Lược đồ XSD mà bạn dán cũng vậy.