Package apple.foundation

Class NSURLComponents

    • Constructor Detail

      • NSURLComponents

        protected NSURLComponents​(org.moe.natj.general.Pointer peer)

    • Method Detail

      • accessInstanceVariablesDirectly

        public static boolean accessInstanceVariablesDirectly()

      • allocWithZone

        public static java.lang.Object allocWithZone​(org.moe.natj.general.ptr.VoidPtr zone)

      • automaticallyNotifiesObserversForKey

        public static boolean automaticallyNotifiesObserversForKey​(java.lang.String key)

      • cancelPreviousPerformRequestsWithTarget

        public static void cancelPreviousPerformRequestsWithTarget​(java.lang.Object aTarget)

      • cancelPreviousPerformRequestsWithTargetSelectorObject

        public static void cancelPreviousPerformRequestsWithTargetSelectorObject​(java.lang.Object aTarget,
                                                                         org.moe.natj.objc.SEL aSelector,
                                                                         java.lang.Object anArgument)

      • classFallbacksForKeyedArchiver

        public static NSArray<java.lang.String> classFallbacksForKeyedArchiver()

      • classForKeyedUnarchiver

        public static org.moe.natj.objc.Class classForKeyedUnarchiver()

      • componentsWithString

        public static NSURLComponents componentsWithString​(java.lang.String URLString)
        Initializes and returns a newly created NSURLComponents with a URL string. If the URLString is malformed, nil is returned.

      • componentsWithURLResolvingAgainstBaseURL

        public static NSURLComponents componentsWithURLResolvingAgainstBaseURL​(NSURL url,
                                                                       boolean resolve)
        Initializes and returns a newly created NSURLComponents with the components of a URL. If resolvingAgainstBaseURL is YES and url is a relative URL, the components of [url absoluteURL] are used. If the url string from the NSURL is malformed, nil is returned.

      • debugDescription_static

        public static java.lang.String debugDescription_static()

      • description_static

        public static java.lang.String description_static()

      • hash_static

        public static long hash_static()

      • instanceMethodSignatureForSelector

        public static NSMethodSignature instanceMethodSignatureForSelector​(org.moe.natj.objc.SEL aSelector)

      • instancesRespondToSelector

        public static boolean instancesRespondToSelector​(org.moe.natj.objc.SEL aSelector)

      • isSubclassOfClass

        public static boolean isSubclassOfClass​(org.moe.natj.objc.Class aClass)

      • keyPathsForValuesAffectingValueForKey

        public static NSSet<java.lang.String> keyPathsForValuesAffectingValueForKey​(java.lang.String key)

      • new_objc

        public static java.lang.Object new_objc()

      • resolveClassMethod

        public static boolean resolveClassMethod​(org.moe.natj.objc.SEL sel)

      • resolveInstanceMethod

        public static boolean resolveInstanceMethod​(org.moe.natj.objc.SEL sel)

      • setVersion_static

        public static void setVersion_static​(long aVersion)

      • superclass_static

        public static org.moe.natj.objc.Class superclass_static()

      • version_static

        public static long version_static()

      • URL

        public NSURL URL()
        Returns a URL created from the NSURLComponents. If the NSURLComponents has an authority component (user, password, host or port) and a path component, then the path must either begin with "/" or be an empty string. If the NSURLComponents does not have an authority component (user, password, host or port) and has a path component, the path component must not start with "//". If those requirements are not met, nil is returned.

      • URLRelativeToURL

        public NSURL URLRelativeToURL​(NSURL baseURL)
        Returns a URL created from the NSURLComponents relative to a base URL. If the NSURLComponents has an authority component (user, password, host or port) and a path component, then the path must either begin with "/" or be an empty string. If the NSURLComponents does not have an authority component (user, password, host or port) and has a path component, the path component must not start with "//". If those requirements are not met, nil is returned.

      • copyWithZone

        public java.lang.Object copyWithZone​(org.moe.natj.general.ptr.VoidPtr zone)
        Specified by:
        copyWithZone in interface NSCopying

      • fragment

        public java.lang.String fragment()

      • host

        public java.lang.String host()

      • init

        public NSURLComponents init()
        Initialize a NSURLComponents with all components undefined. Designated initializer.
        Overrides:
        init in class NSObject

      • initWithString

        public NSURLComponents initWithString​(java.lang.String URLString)
        Initialize a NSURLComponents with a URL string. If the URLString is malformed, nil is returned.

      • initWithURLResolvingAgainstBaseURL

        public NSURLComponents initWithURLResolvingAgainstBaseURL​(NSURL url,
                                                          boolean resolve)
        Initialize a NSURLComponents with the components of a URL. If resolvingAgainstBaseURL is YES and url is a relative URL, the components of [url absoluteURL] are used. If the url string from the NSURL is malformed, nil is returned.

      • password

        public java.lang.String password()

      • path

        public java.lang.String path()

      • percentEncodedFragment

        public java.lang.String percentEncodedFragment()

      • percentEncodedHost

        public java.lang.String percentEncodedHost()

      • percentEncodedPassword

        public java.lang.String percentEncodedPassword()

      • percentEncodedPath

        public java.lang.String percentEncodedPath()

      • percentEncodedQuery

        public java.lang.String percentEncodedQuery()

      • percentEncodedUser

        public java.lang.String percentEncodedUser()
        Getting these properties retains any percent encoding these components may have. Setting these properties assumes the component string is already correctly percent encoded. Attempting to set an incorrectly percent encoded string will cause an exception. Although ';' is a legal path character, it is recommended that it be percent-encoded for best compatibility with NSURL (-stringByAddingPercentEncodingWithAllowedCharacters: will percent-encode any ';' characters if you pass the URLPathAllowedCharacterSet).

      • port

        public NSNumber port()
        Attempting to set a negative port number will cause an exception.

      • query

        public java.lang.String query()

      • queryItems

        public NSArray<? extends NSURLQueryItem> queryItems()
        The query component as an array of NSURLQueryItems for this NSURLComponents. Each NSURLQueryItem represents a single key-value pair, Note that a name may appear more than once in a single query string, so the name values are not guaranteed to be unique. If the NSURLComponents has an empty query component, returns an empty array. If the NSURLComponents has no query component, returns nil. The queryItems getter returns an array of NSURLQueryItems in the order in which they appear in the original query string. Any percent-encoding in a NSURLQueryItem name or value is removed. The queryItems setter combines an array containing any number of NSURLQueryItems, each of which represents a single key-value pair, into a query string and sets the NSURLComponents query property. If the NSURLQueryItems name or value strings contain any characters not allowed in a URL's query component, those characters are percent-encoded. In addition, any '&' and '=' characters in a NSURLQueryItem name are percent-encoded. Passing an empty array sets the query component of the NSURLComponents to an empty string. Passing nil removes the query component of the NSURLComponents. - note: If a NSURLQueryItem name-value pair is empty (i.e. the query string starts with '&', ends with '&', or has "&&" within it), you get a NSURLQueryItem with a zero-length name and a nil value. If a NSURLQueryItem name-value pair has nothing before the equals sign, you get a zero-length name. If a NSURLQueryItem name-value pair has nothing after the equals sign, you get a zero-length value. If a NSURLQueryItem name-value pair has no equals sign, the NSURLQueryItem name-value pair string is the name and you get a nil value.

      • rangeOfFragment

        public NSRange rangeOfFragment()

      • rangeOfHost

        public NSRange rangeOfHost()

      • rangeOfPassword

        public NSRange rangeOfPassword()

      • rangeOfPath

        public NSRange rangeOfPath()

      • rangeOfPort

        public NSRange rangeOfPort()

      • rangeOfQuery

        public NSRange rangeOfQuery()

      • rangeOfScheme

        public NSRange rangeOfScheme()
        These properties return the character range of a component in the URL string returned by -[NSURLComponents string]. If the component does not exist in the NSURLComponents object, {NSNotFound, 0} is returned. Note: Zero length components are legal. For example, the URL string "scheme://:@/?#" has a zero length user, password, host, query and fragment; the URL strings "scheme:" and "" both have a zero length path.

      • rangeOfUser

        public NSRange rangeOfUser()

      • scheme

        public java.lang.String scheme()
        Attempting to set the scheme with an invalid scheme string will cause an exception.

      • setFragment

        public void setFragment​(java.lang.String value)

      • setHost

        public void setHost​(java.lang.String value)

      • setPassword

        public void setPassword​(java.lang.String value)

      • setPath

        public void setPath​(java.lang.String value)

      • setPercentEncodedFragment

        public void setPercentEncodedFragment​(java.lang.String value)

      • setPercentEncodedHost

        public void setPercentEncodedHost​(java.lang.String value)

      • setPercentEncodedPassword

        public void setPercentEncodedPassword​(java.lang.String value)

      • setPercentEncodedPath

        public void setPercentEncodedPath​(java.lang.String value)

      • setPercentEncodedQuery

        public void setPercentEncodedQuery​(java.lang.String value)

      • setPercentEncodedUser

        public void setPercentEncodedUser​(java.lang.String value)
        Getting these properties retains any percent encoding these components may have. Setting these properties assumes the component string is already correctly percent encoded. Attempting to set an incorrectly percent encoded string will cause an exception. Although ';' is a legal path character, it is recommended that it be percent-encoded for best compatibility with NSURL (-stringByAddingPercentEncodingWithAllowedCharacters: will percent-encode any ';' characters if you pass the URLPathAllowedCharacterSet).

      • setPort

        public void setPort​(NSNumber value)
        Attempting to set a negative port number will cause an exception.

      • setQuery

        public void setQuery​(java.lang.String value)

      • setQueryItems

        public void setQueryItems​(NSArray<? extends NSURLQueryItem> value)
        The query component as an array of NSURLQueryItems for this NSURLComponents. Each NSURLQueryItem represents a single key-value pair, Note that a name may appear more than once in a single query string, so the name values are not guaranteed to be unique. If the NSURLComponents has an empty query component, returns an empty array. If the NSURLComponents has no query component, returns nil. The queryItems getter returns an array of NSURLQueryItems in the order in which they appear in the original query string. Any percent-encoding in a NSURLQueryItem name or value is removed. The queryItems setter combines an array containing any number of NSURLQueryItems, each of which represents a single key-value pair, into a query string and sets the NSURLComponents query property. If the NSURLQueryItems name or value strings contain any characters not allowed in a URL's query component, those characters are percent-encoded. In addition, any '&' and '=' characters in a NSURLQueryItem name are percent-encoded. Passing an empty array sets the query component of the NSURLComponents to an empty string. Passing nil removes the query component of the NSURLComponents. - note: If a NSURLQueryItem name-value pair is empty (i.e. the query string starts with '&', ends with '&', or has "&&" within it), you get a NSURLQueryItem with a zero-length name and a nil value. If a NSURLQueryItem name-value pair has nothing before the equals sign, you get a zero-length name. If a NSURLQueryItem name-value pair has nothing after the equals sign, you get a zero-length value. If a NSURLQueryItem name-value pair has no equals sign, the NSURLQueryItem name-value pair string is the name and you get a nil value.

      • setScheme

        public void setScheme​(java.lang.String value)
        Attempting to set the scheme with an invalid scheme string will cause an exception.

      • setUser

        public void setUser​(java.lang.String value)

      • string

        public java.lang.String string()
        Returns a URL string created from the NSURLComponents. If the NSURLComponents has an authority component (user, password, host or port) and a path component, then the path must either begin with "/" or be an empty string. If the NSURLComponents does not have an authority component (user, password, host or port) and has a path component, the path component must not start with "//". If those requirements are not met, nil is returned.

      • user

        public java.lang.String user()

      • percentEncodedQueryItems

        public NSArray<? extends NSURLQueryItem> percentEncodedQueryItems()
        The percentEncodedQueryItems getter returns an array of NSURLQueryItems in the order in which they appear in the original query string. Any percent-encoding in a NSURLQueryItem name or value is retained. The percentEncodedQueryItems setter combines an array containing any number of NSURLQueryItems, each of which represents a single key-value pair, into a query string and sets the NSURLComponents query property. This property assumes the NSURLQueryItem names and values are already correctly percent-encoded, and that the NSURLQueryItem names do not contain the query item delimiter characters '&' and '='. Attempting to set an incorrectly percent-encoded NSURLQueryItem or a NSURLQueryItem name with the query item delimiter characters '&' and '=' will cause an exception.

      • setPercentEncodedQueryItems

        public void setPercentEncodedQueryItems​(NSArray<? extends NSURLQueryItem> value)
        The percentEncodedQueryItems getter returns an array of NSURLQueryItems in the order in which they appear in the original query string. Any percent-encoding in a NSURLQueryItem name or value is retained. The percentEncodedQueryItems setter combines an array containing any number of NSURLQueryItems, each of which represents a single key-value pair, into a query string and sets the NSURLComponents query property. This property assumes the NSURLQueryItem names and values are already correctly percent-encoded, and that the NSURLQueryItem names do not contain the query item delimiter characters '&' and '='. Attempting to set an incorrectly percent-encoded NSURLQueryItem or a NSURLQueryItem name with the query item delimiter characters '&' and '=' will cause an exception.