Apex Developer Guide

Getting Started
Writing Apex
Ways to Invoke Apex
Finishing Touches
Reference
Apex DML Operations
ApexPages Namespace
AppLauncher Namespace
Approval Namespace
Auth Namespace
Cache Namespace
Canvas Namespace
ChatterAnswers Namespace
ConnectApi Namespace
Database Namespace
Datacloud Namespace
DataSource Namespace
Dom Namespace
Flow Namespace
KbManagement Namespace
Messaging Namespace
Process Namespace
QuickAction Namespace
Reports Namespace
Schema Namespace
Search Namespace
Site Namespace
Support Namespace
System Namespace
Address Class
Answers Class
ApexPages Class
Approval Class
Blob Class
Boolean Class
BusinessHours Class
Cases Class
Comparable Interface
Continuation Class
Cookie Class
Crypto Class
Custom Settings Methods
Database Class
Date Class
Datetime Class
Decimal Class
Double Class
EncodingUtil Class
Enum Methods
Exception Class and Built-In Exceptions
FlexQueue Class
Http Class
HttpCalloutMock Interface
HttpRequest Class
HttpResponse Class
Id Class
Ideas Class
InstallHandler Interface
Integer Class
JSON Class
JSONGenerator Class
JSONParser Class
JSONToken Enum
Limits Class
List Class
Location Class
Long Class
Map Class
Matcher Class
Math Class
Messaging Class
MultiStaticResourceCalloutMock Class
Network Class
PageReference Class
Pattern Class
Queueable Interface
QueueableContext Interface
QuickAction Class
RemoteObjectController
ResetPasswordResult Class
RestContext Class
RestRequest Class
RestResponse Class
SandboxPostCopy Interface
Schedulable Interface
SchedulableContext Interface
Schema Class
Search Class
SelectOption Class
Set Class
Site Class
sObject Class
StaticResourceCalloutMock Class
String Class
System Class
Test Class
Time Class
TimeZone Class
Trigger Class
Type Class
UninstallHandler Interface
URL Class
URL Constructors
URL Methods
UserInfo Class
Version Class
WebServiceCallout Class
WebServiceMock Interface
XmlStreamReader Class
XmlStreamWriter Class
TerritoryMgmt Namespace
TxnSecurity Namespace
UserProvisioning Namespace
Appendices
Glossary
PDF

Newer Version Available

This content describes an older version of this product. View Latest

URL Class

Represents a uniform resource locator (URL) and provides access to parts of the URL. Enables access to the Salesforce instance URL.

Namespace

System

Usage

Use the methods of the System.URL class to create links to objects in your organization. Such objects can be files, images, logos, or records that you want to include in external emails, in activities, or in Chatter posts. For example, you can create a link to a file uploaded as an attachment to a Chatter post by concatenating the Salesforce base URL with the file ID, as shown in the following example:
The following example creates a link to a Salesforce record. The full URL is created by concatenating the Salesforce base URL with the record ID.

Example

In this example, the base URL and the full request URL of the current Salesforce server instance are retrieved. Next, a URL pointing to a specific account object is created. Finally, components of the base and full URL are obtained. This example prints out all the results to the debug log output.

URL Constructors

The following are constructors for URL.

Url(spec)

Creates a new instance of the URL class using the specified string representation of the URL.

Signature

public Url(String spec)

Parameters

spec
Type: String
The string to parse as a URL.

Url(context, spec)

Creates a new instance of the URL class by parsing the specified spec within the specified context.

Signature

public Url(Url context, String spec)

Parameters

context
Type: URL
The context in which to parse the specification.
spec
Type: String
The string to parse as a URL.

Usage

The new URL is created from the given context URL and the spec argument as described in RFC2396 "Uniform Resource Identifiers : Generic * Syntax" :

For more information about the arguments of this constructor, see the corresponding URL(java.net.URL, java.lang.String) constructor for Java.

Url(protocol, host, file)

Creates a new instance of the URL class using the specified protocol, host, and file on the host. The default port for the specified protocol is used.

Signature

public Url(String protocol, String host, String file)

Parameters

protocol
Type: String
The protocol name for this URL.
host
Type: String
The host name for this URL.
file
Type: String
The file name for this URL.

Url(protocol, host, port, file)

Creates a new instance of the URL class using the specified protocol, host, port, and file on the host.

Signature

public Url(String protocol, String host, Integer port, String file)

Parameters

protocol
Type: String
The protocol name for this URL.
host
Type: String
The host name for this URL.
port
Type: Integer
The port number for this URL.
file
Type: String
The file name for this URL.

URL Methods

The following are methods for URL.

getAuthority()

Returns the authority portion of the current URL.

Signature

public String getAuthority()

Return Value

Type: String

getCurrentRequestUrl()

Returns the URL of an entire request on a Salesforce instance.

Signature

public static System.URL getCurrentRequestUrl()

Return Value

Type: System.URL

Usage

An example of a URL for an entire request is https://yourInstance.salesforce.com/apex/myVfPage.apexp.

getDefaultPort()

Returns the default port number of the protocol associated with the current URL.

Signature

public Integer getDefaultPort()

Return Value

Type: Integer

Usage

Returns -1 if the URL scheme or the stream protocol handler for the URL doesn't define a default port number.

getFile()

Returns the file name of the current URL.

Signature

public String getFile()

Return Value

Type: String

getFileFieldURL(entityId, fieldName)

Returns the download URL for a file attachment.

Signature

public static String getFileFieldURL(String entityId, String fieldName)

Parameters

entityId
Type: String
Specifies the ID of the entity that holds the file data.
fieldName
Type: String
Specifies the API name of a file field component, such as AttachmentBody.

Return Value

Type: String

Usage

Example:

Example

getHost()

Returns the host name of the current URL.

Signature

public String getHost()

Return Value

Type: String

getPath()

Returns the path portion of the current URL.

Signature

public String getPath()

Return Value

Type: String

getPort()

Returns the port of the current URL.

Signature

public Integer getPort()

Return Value

Type: Integer

getProtocol()

Returns the protocol name of the current URL, such as, https.

Signature

public String getProtocol()

Return Value

Type: String

getQuery()

Returns the query portion of the current URL.

Signature

public String getQuery()

Return Value

Type: String

Usage

Returns null if no query portion exists.

getRef()

Returns the anchor of the current URL.

Signature

public String getRef()

Return Value

Type: String

Usage

Returns null if no query portion exists.

getSalesforceBaseUrl()

Returns the URL of the Salesforce instance.

Signature

public static System.URL getSalesforceBaseUrl()

Return Value

Type: System.URL

Usage

An example of an instance URL is https://yourInstance.salesforce.com/.

getUserInfo()

Gets the UserInfo portion of the current URL.

Signature

public String getUserInfo()

Return Value

Type: String

Usage

Returns null if no UserInfo portion exists.

sameFile(URLToCompare)

Compares the current URL with the specified URL object, excluding the fragment component.

Signature

public Boolean sameFile(System.URL URLToCompare)

Parameters

URLToCompare
Type: System.URL

Return Value

Type: Boolean

Returns true if both URL objects reference the same remote resource; otherwise, returns false.

Usage

For more information about the syntax of URIs and fragment components, see RFC3986.

toExternalForm()

Returns a string representation of the current URL.

Signature

public String toExternalForm()

Return Value

Type: String