apple.foundation

Class NSURLComponents

java.lang.Object

org.moe.natj.general.NativeObject

org.moe.natj.objc.ObjCObject

apple.NSObject

apple.foundation.NSURLComponents

All Implemented Interfaces:

NSCopying, NSObject

public class NSURLComponents
extends NSObject
implements NSCopying

Nested Class Summary

Nested classes/interfaces inherited from class apple.NSObject

NSObject.Function_instanceMethodForSelector_ret, NSObject.Function_methodForSelector_ret

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	NSURLComponents(org.moe.natj.general.Pointer peer)

Method Summary

Modifier and Type	Method and Description
static boolean	accessInstanceVariablesDirectly()
static NSURLComponents	alloc()
static NSURLComponents	allocWithZone(org.moe.natj.general.ptr.VoidPtr zone)
static boolean	automaticallyNotifiesObserversForKey(java.lang.String key)
static void	cancelPreviousPerformRequestsWithTarget(java.lang.Object aTarget)
static void	cancelPreviousPerformRequestsWithTargetSelectorObject(java.lang.Object aTarget, org.moe.natj.objc.SEL aSelector, java.lang.Object anArgument)
static NSArray<java.lang.String>	classFallbacksForKeyedArchiver()
static org.moe.natj.objc.Class	classForKeyedUnarchiver()
static NSURLComponents	componentsWithString(java.lang.String URLString) Initializes and returns a newly created NSURLComponents with a URL string.
static NSURLComponents	componentsWithURLResolvingAgainstBaseURL(NSURL url, boolean resolve) Initializes and returns a newly created NSURLComponents with the components of a URL.
java.lang.Object	copyWithZone(org.moe.natj.general.ptr.VoidPtr zone)
static java.lang.String	debugDescription_static()
static java.lang.String	description_static()
java.lang.String	fragment()
static long	hash_static()
java.lang.String	host()
NSURLComponents	init() Initialize a NSURLComponents with all components undefined.
NSURLComponents	initWithString(java.lang.String URLString) Initialize a NSURLComponents with a URL string.
NSURLComponents	initWithURLResolvingAgainstBaseURL(NSURL url, boolean resolve) Initialize a NSURLComponents with the components of a URL.
static NSObject.Function_instanceMethodForSelector_ret	instanceMethodForSelector(org.moe.natj.objc.SEL aSelector)
static NSMethodSignature	instanceMethodSignatureForSelector(org.moe.natj.objc.SEL aSelector)
static boolean	instancesRespondToSelector(org.moe.natj.objc.SEL aSelector)
static boolean	isSubclassOfClass(org.moe.natj.objc.Class aClass)
static NSSet<java.lang.String>	keyPathsForValuesAffectingValueForKey(java.lang.String key)
static NSURLComponents	new_objc()
java.lang.String	password()
java.lang.String	path()
java.lang.String	percentEncodedFragment()
java.lang.String	percentEncodedHost()
java.lang.String	percentEncodedPassword()
java.lang.String	percentEncodedPath()
java.lang.String	percentEncodedQuery()
NSArray<? extends NSURLQueryItem>	percentEncodedQueryItems() The percentEncodedQueryItems getter returns an array of NSURLQueryItems in the order in which they appear in the original query string.
java.lang.String	percentEncodedUser() Getting these properties retains any percent encoding these components may have.
NSNumber	port() Attempting to set a negative port number will cause an exception.
java.lang.String	query()
NSArray<? extends NSURLQueryItem>	queryItems() The query component as an array of NSURLQueryItems for this NSURLComponents.
NSRange	rangeOfFragment()
NSRange	rangeOfHost()
NSRange	rangeOfPassword()
NSRange	rangeOfPath()
NSRange	rangeOfPort()
NSRange	rangeOfQuery()
NSRange	rangeOfScheme() These properties return the character range of a component in the URL string returned by -[NSURLComponents string].
NSRange	rangeOfUser()
static boolean	resolveClassMethod(org.moe.natj.objc.SEL sel)
static boolean	resolveInstanceMethod(org.moe.natj.objc.SEL sel)
java.lang.String	scheme() Attempting to set the scheme with an invalid scheme string will cause an exception.
void	setFragment(java.lang.String value)
void	setHost(java.lang.String value)
void	setPassword(java.lang.String value)
void	setPath(java.lang.String value)
void	setPercentEncodedFragment(java.lang.String value)
void	setPercentEncodedHost(java.lang.String value)
void	setPercentEncodedPassword(java.lang.String value)
void	setPercentEncodedPath(java.lang.String value)
void	setPercentEncodedQuery(java.lang.String value)
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.
void	setPercentEncodedUser(java.lang.String value) Getting these properties retains any percent encoding these components may have.
void	setPort(NSNumber value) Attempting to set a negative port number will cause an exception.
void	setQuery(java.lang.String value)
void	setQueryItems(NSArray<? extends NSURLQueryItem> value) The query component as an array of NSURLQueryItems for this NSURLComponents.
void	setScheme(java.lang.String value) Attempting to set the scheme with an invalid scheme string will cause an exception.
void	setUser(java.lang.String value)
static void	setVersion_static(long aVersion)
java.lang.String	string() Returns a URL string created from the NSURLComponents.
static org.moe.natj.objc.Class	superclass_static()
NSURL	URL() Returns a URL created from the NSURLComponents.
NSURL	URLRelativeToURL(NSURL baseURL) Returns a URL created from the NSURLComponents relative to a base URL.
java.lang.String	user()
static long	version_static()

Methods inherited from class apple.NSObject

accessibilityActivate, accessibilityActivationPoint, accessibilityAssistiveTechnologyFocusedIdentifiers, accessibilityAttributedHint, accessibilityAttributedLabel, accessibilityAttributedUserInputLabels, accessibilityAttributedValue, accessibilityContainerType, accessibilityCustomActions, accessibilityCustomRotors, accessibilityDecrement, accessibilityDragSourceDescriptors, accessibilityDropPointDescriptors, accessibilityElementAtIndex, accessibilityElementCount, accessibilityElementDidBecomeFocused, accessibilityElementDidLoseFocus, accessibilityElementIsFocused, accessibilityElements, accessibilityElementsHidden, accessibilityFrame, accessibilityHint, accessibilityIncrement, accessibilityLabel, accessibilityLanguage, accessibilityNavigationStyle, accessibilityPath, accessibilityPerformEscape, accessibilityPerformMagicTap, accessibilityRespondsToUserInteraction, accessibilityScroll, accessibilityTextualContext, accessibilityTraits, accessibilityUserInputLabels, accessibilityValue, accessibilityViewIsModal, addObserverForKeyPathOptionsContext, attemptRecoveryFromErrorOptionIndex, attemptRecoveryFromErrorOptionIndexDelegateDidRecoverSelectorContextInfo, autoContentAccessingProxy, awakeAfterUsingCoder, awakeFromNib, class_objc, classForCoder, classForKeyedArchiver, copy, dealloc, debugDescription, description, dictionaryWithValuesForKeys, didChangeValueForKey, didChangeValueForKeyWithSetMutationUsingObjects, didChangeValuesAtIndexesForKey, doesNotRecognizeSelector, fileManagerShouldProceedAfterError, fileManagerWillProcessPath, finalize_objc, forwardingTargetForSelector, forwardInvocation, hash, indexOfAccessibilityElement, isAccessibilityElement, isEqual, isKindOfClass, isMemberOfClass, isProxy, methodForSelector, methodSignatureForSelector, mutableArrayValueForKey, mutableArrayValueForKeyPath, mutableCopy, mutableOrderedSetValueForKey, mutableOrderedSetValueForKeyPath, mutableSetValueForKey, mutableSetValueForKeyPath, observationInfo, observeValueForKeyPathOfObjectChangeContext, performSelector, performSelectorInBackgroundWithObject, performSelectorOnMainThreadWithObjectWaitUntilDone, performSelectorOnMainThreadWithObjectWaitUntilDoneModes, performSelectorOnThreadWithObjectWaitUntilDone, performSelectorOnThreadWithObjectWaitUntilDoneModes, performSelectorWithObject, performSelectorWithObjectAfterDelay, performSelectorWithObjectAfterDelayInModes, performSelectorWithObjectWithObject, prepareForInterfaceBuilder, provideImageDataBytesPerRowOrigin_Size_UserInfo, removeObserverForKeyPath, removeObserverForKeyPathContext, replacementObjectForCoder, replacementObjectForKeyedArchiver, respondsToSelector, self, setAccessibilityActivationPoint, setAccessibilityAttributedHint, setAccessibilityAttributedLabel, setAccessibilityAttributedUserInputLabels, setAccessibilityAttributedValue, setAccessibilityContainerType, setAccessibilityCustomActions, setAccessibilityCustomRotors, setAccessibilityDragSourceDescriptors, setAccessibilityDropPointDescriptors, setAccessibilityElements, setAccessibilityElementsHidden, setAccessibilityFrame, setAccessibilityHint, setAccessibilityLabel, setAccessibilityLanguage, setAccessibilityNavigationStyle, setAccessibilityPath, setAccessibilityRespondsToUserInteraction, setAccessibilityTextualContext, setAccessibilityTraits, setAccessibilityUserInputLabels, setAccessibilityValue, setAccessibilityViewIsModal, setIsAccessibilityElement, setNilValueForKey, setObservationInfo, setShouldGroupAccessibilityChildren, setValueForKey, setValueForKeyPath, setValueForUndefinedKey, setValuesForKeysWithDictionary, shouldGroupAccessibilityChildren, superclass, validateValueForKeyError, validateValueForKeyPathError, valueForKey, valueForKeyPath, valueForUndefinedKey, willChangeValueForKey, willChangeValueForKeyWithSetMutationUsingObjects, willChangeValuesAtIndexesForKey

Methods inherited from class org.moe.natj.objc.ObjCObject

equals, toString

Methods inherited from class org.moe.natj.general.NativeObject

finalize, getPeer, getPeerPointer

Methods inherited from class java.lang.Object

clone, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

NSURLComponents

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

Method Detail

accessInstanceVariablesDirectly

public static boolean accessInstanceVariablesDirectly()

alloc

public static NSURLComponents alloc()

allocWithZone

public static NSURLComponents 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()

instanceMethodForSelector

public static NSObject.Function_instanceMethodForSelector_ret instanceMethodForSelector(org.moe.natj.objc.SEL aSelector)

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 NSURLComponents 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.