3.2.2 Giao thức IMAP4 (RFC2060, RFC2193…)
3.2.2.1 Các lệnh của IMAP4
Những tập lệnh của IMAP4rev1 được định nghĩa trong rfc2060 cũng nhưng quá trình bắt đầu và kết thúc của một phiên làm việc. Vì trong chương trình em chỉ sử dụng một số lệnh cơ bản trong bộ giao thức này, dưới đây là ý nghĩ cũng như cách sử dụng chúng.
♦ CAPABILITY - Arguments: none
- Kết quả trả về : OK - capability completed
BAD - command unknown or arguments invalid
- Đây là lệnh thực hiện trước tiên của bất kỳ một trình mail Client nào muốn lấy mail từ trình chủ bằng giao thức IMAP, mục đích là kiểm tra version giao thức có đáp ứng được yêu cầu không. Version hiện nay đang dùng là IMAP4(IMAP4rev1).
Ví dụ C: abcd CAPABILITY S: * CAPABILITY IMAP4rev1
S: abcd OK CAPABILITY completed
♦ LOGIN
- Arguments: [user name] [password ]
- Kết quả trả về là: OK - login completed, now in authenticated state NO - login failure: user name or password rejected BAD - command unknown or arguments invalid
- Lệnh này để xác nhận người sử dụng có hợp pháp không? Nếu thành công thì người dùng sẽ thực hiện các thao tác lệnh tiếp theo.
Ví dụ C: a001 LOGIN tuyentm01 kimphung S: a001 OK LOGIN completed
♦ CHECK
- Arguments: none
- Kết quả trả về: OK - check completed
BAD - command unknown or arguments invalid
- Lệnh này dùng để kiểm tra tại thời điểm này lệnh SELECT đã thực hiện hay chưa, nếu thực hiện rồi trả về OK.
♦ SELECT
- Arguments: mailbox name (tên hòm thư)
- Kết quả trả về : OK - select completed, now in selected state NO - select failure, now in authenticated state: no such mailbox, can't access mailbox
BAD - command unknown or arguments invalid
- Lệnh Select dùng để nhận biết được hòm thư có bao nhiêu thư bao gồm thư mới, thư đọc rồi và thư đã xoá. Lệnh này cho phép ta thay đổi thuộc tính của hòm thư cũng như nhưng lá thư mà chúng lưu trữ bởi các lệnh khác trong IMAP.
Ví dụ C: A142 SELECT INBOX S: * 172 EXISTS
S: * 1 RECENT
S: * OK [UNSEEN 12] Message 12 is first unseen S: * OK [UIDVALIDITY 3857529045] UIDs valid S: * FLAGS (\Answered \Flagged \Deleted \Seen \Draft) S: * OK [PERMANENTFLAGS (\Deleted \Seen \*)] Limited S: A142 OK [READ-WRITE] SELECT completed.
- Trong ví dụ trên chúng ta quan tâm các thông số sau:
EXISTS : tổng số lá thư mà hòm thư này lưu trữ ví dụ trên là 172 lá thư.
RECENT : là số lá thư mới trong thời gian gần đây mà người sử dụng chưa đọc ví dụ trên là 1.
UNSEEN : là tổng số lá thư củ mà người dùng chỉ nhìn thấy nhưng nội dung chưa xem qua.
UIDVALIDITY : dùng để chỉ định trạng thái của hòm thư đây là một thông số không quan trong.Mổi mail Server sẽ có cách đặc tả thông số này
khác nhau tuỳ từng mục đích sử dụng nó của các nhà quản trị mail thông số này liên quan đến lệnh UID.
♦CLOSE
- Arguments: none
- Kết quả trả về : OK - close completed, now in authenticated state NO - close failure: no mailbox selected
BAD - command unknown or arguments invalid
- Lệnh này dùng để đóng lệnh SELECT lại hay có thể hiểu loại bỏ lệnh này và không lưu lại các thuộc tính đã thay đổi với hòm thư này.
♦ FETCH
- Arguments: message set message data item names - Kết quả: OK - fetch completed
NO - fetch error: can't fetch that data
BAD - command unknown or arguments invalid
- Lệnh dùng để hiển thị nội dung của một lá thư. Thông số theo sau gồm có hai thông số: đầu tiên là số thứ tự của lá thư và thông số thư hai là message data item names nhưng thông số này phải tuân theo RFC822 được trình bày ở trên.
Ví dụ: C: A654 FETCH 2:4 (FLAGS BODY[HEADER.FIELDS (DATE FROM)])
S: * 2 FETCH ....
S: * 3 FETCH ....
S: * 4 FETCH ....
S: A654 OK FETCH completed
♦ UID
- Arguments: là các lệnh trong IMAP
- Kết quả trả về: OK - UID command completed NO - UID command error
BAD - command unknown or arguments invalid
♦ EXAMINE
- Arguments: mailbox name
- Kết quản trả về: OK - examine completed, now in selected state
NO - examine failure, now in authenticated state: no such mailbox, can't access mailbox
BAD - command unknown or arguments invalid
- Lệnh này tương tự như lệnh SELECT cùng một kế quả trả về nhưng khi dùng lệnh này chúng ta chỉ xem thông tin không thay đổi được trạng thái của hòm thư cũng như các thuộc tính của nó.
Ví dụ: C: A932 EXAMINE Inbox S: * 17 EXISTS
S: * 2 RECENT
S: * OK [UNSEEN 8] Message 8 is first unseen S: * OK [UIDVALIDITY 3857529045] UIDs valid S: * FLAGS (\Answered \Flagged \Deleted \Seen \Draft)
S: * OK [PERMANENTFLAGS ()] No permanent flags permitted S: A932 OK [READ-ONLY] EXAMINE completed
♦ CREATE
- Arguments: tên hòm thư cần tạo.
- Kết quả trả về: OK - create completed
NO - create failure: can't create mailbox with that name BAD - command unknown or arguments invalid
- Lênh tạo ra một hòm thư mới với tên đã chọn và trả lại là OK nếu quá trình tạo ra hòm thư trên Server không gặp lỗi.
Ví dụ: C: A003 CREATE Tuyen
S: A003 OK CREATE completed C: A004 CREATE Inbox
S: A004 No mailbox name Exist
♦ DELETE
- Arguments: tên hòm thư cần xoá.
- Kết quả trả về: OK - delete completed
NO - delete failure: can't delete mailbox with that name BAD - command unknown or arguments invalid
- Lệnh xoá hòm thư, nếu xoá thành công thì kết quả nhận được là OK.
Ví dụ: C: A682 LIST "" * S: * LIST () "/" Inbox
S: * LIST () "/" Tuyen
S: A682 OK LIST completed C: A683 DELETE Tuyen
S: A683 OK DELETE completed C: A684 DELETE Tuyen
S: A684 NO Name "Tuyen" has inferior hierarchical names C: A686 LIST "" *
S: * LIST () "/" Inbox
S: A686 OK LIST completed
♦ RENAME
- Arguments: (tên hòm thư tồn tại) (tên hòm thư mới).
- Kết quả: OK - rename completed
NO - rename failure: can't rename mailbox with that name, can't rename to mailbox with that name
BAD - command unknown or arguments invalid - Lệnh chuyển đổi tên hòm thư, kết quả là OK nếu thành công.
♦ COPY
- Arguments: tên lá thư đến tên hòm thư - Kết quả trả về: OK - copy completed
NO - copy error: can't copy those messages or to that name
BAD - command unknown or arguments invalid - Đây là lệnh copy một lá thư từ hòm thư này sang hòm thư khác.
Ví dụ: C: A003 COPY 2:4 MEETING S: A003 OK COPY completed
♦ SUBSCRIBE
- Arguments: tên hòm thư
- Kết quả trả về: OK - subscribe completed
NO - subscribe failure: can't subscribe to that name BAD - command unknown or arguments invalid
- Lệnh dùng để thiết lập thuộc tính active của hòm thư,tuy nhiên nó không thể thay đổi được đặc tính hòm thư hay nói cách khác nó dùng để kiểm tra xem hòm thư này có tồn tại hay không
♦ UNSUBSCRIBE
- Arguments: tên hòm thư
- Kết quả trả về:OK - unsubscribe completed
NO - unsubscribe failure: can't unsubscribe that name BAD - command unknown or arguments invalid
- Lệnh này ngược lại với SUBSCRIBE nghĩa là nó loại bỏ thuộc tính active của hòm thư.
♦ LIST
- Arguments: tên hay những ký tự đặc trưng.
- Kết quả trả về:OK - list completed
NO - list failure: can't list that reference or name BAD - command unknown or arguments invalid
- Nếu tên hay những ký tự theo sau hợp lệ thì lệnh này trả về tập tên các hòm thư, thường tên hay ký tự theo sau là “% ,*, “”, /, String*,”. Chúng ta tạm hiểu nó như một lệnh Dir trong MS-DOS.
Ví dụ: C: A101 LIST "" ""
S: * LIST (\Noselect) "/" ""
S: A101 OK LIST Completed
C: A102 LIST Tuy* ""
S: * LIST (\Noselect) "/" ""
S: A102 OK LIST Completed