ObjFW  Diff

Differences From Artifact [3cc0432376]:

To Artifact [ade0fe6ddd]:


15
16
17
18
19
20
21

22
23
24
25
26
27
28
29
30
15
16
17
18
19
20
21
22
23

24
25
26
27
28
29
30







+

-








#import "OFObject.h"

OF_ASSUME_NONNULL_BEGIN

@class OFArray OF_GENERIC(ObjectType);
@class OFHTTPCookie;
@class OFIRI;
@class OFMutableArray OF_GENERIC(ObjectType);
@class OFURI;

/**
 * @class OFHTTPCookieManager OFHTTPCookieManager.h ObjFW/OFHTTPCookieManager.h
 *
 * @brief A class for managing cookies for multiple domains.
 */
OF_SUBCLASSING_RESTRICTED
42
43
44
45
46
47
48
49

50
51
52
53
54
55

56
57

58
59
60

61
62
63
64
65
66

67
68
69

70
71
72

73
74
75


76
77

78
79
80
81
82
83
84
85
42
43
44
45
46
47
48

49
50
51
52
53
54

55
56

57
58
59

60
61
62
63
64
65

66
67
68

69
70
71

72
73


74
75
76

77
78
79
80
81
82
83
84
85







-
+





-
+

-
+


-
+





-
+


-
+


-
+

-
-
+
+

-
+








 * @brief Create a new cookie manager.
 *
 * @return A new, autoreleased OFHTTPCookieManager
 */
+ (instancetype)manager;

/**
 * @brief Adds the specified cookie for the specified URI.
 * @brief Adds the specified cookie for the specified IRI.
 *
 * @warning This modifies the cookie (e.g. it sets the domain if it is unset)!
 *	    If you do not want this, pass a copy!
 *
 * @param cookie The cookie to add to the manager
 * @param URI The URI for which the cookie should be added
 * @param IRI The IRI for which the cookie should be added
 */
- (void)addCookie: (OFHTTPCookie *)cookie forURI: (OFURI *)URI;
- (void)addCookie: (OFHTTPCookie *)cookie forIRI: (OFIRI *)IRI;

/**
 * @brief Adds the specified cookies for the specified URI.
 * @brief Adds the specified cookies for the specified IRI.
 *
 * @warning This modifies the cookies (e.g. it sets the domain if it is unset)!
 *	    If you do not want this, pass copies!
 *
 * @param cookies An array of cookies to add to the manager
 * @param URI The URI for which the cookies should be added
 * @param IRI The IRI for which the cookies should be added
 */
- (void)addCookies: (OFArray OF_GENERIC(OFHTTPCookie *) *)cookies
	    forURI: (OFURI *)URI;
	    forIRI: (OFIRI *)IRI;

/**
 * @brief Returns the cookies for the specified URI.
 * @brief Returns the cookies for the specified IRI.
 *
 * @param URI The URI for which the cookies should be returned
 * @return The cookies for the specified URI
 * @param IRI The IRI for which the cookies should be returned
 * @return The cookies for the specified IRI
 */
- (OFArray OF_GENERIC(OFHTTPCookie *) *)cookiesForURI: (OFURI *)URI;
- (OFArray OF_GENERIC(OFHTTPCookie *) *)cookiesForIRI: (OFIRI *)IRI;

/**
 * @brief Purges all expired cookies.
 */
- (void)purgeExpiredCookies;
@end

OF_ASSUME_NONNULL_END