Internet service – PB Docs 125

  2. Powerbuilder Documentation
  3. Powerbuilder Documentation Older
  4. Powerbuilder Documentation 12.5
  5. Internet service – PB Docs 125

Internet service

Use the Internet service to:

  • Display
    a Web page in the default browser (HyperLinkToURL function, which
    starts the default browser with the specified URL)

  • Access the HTML for a specified page (GetURL function,
    which performs an HTTP Get)

  • Send data to a CGI, ISAPI, or NSAPI program (PostURL function,
    which performs an HTTP Post)

Hyperlinking to a URL

You call the Internet service’s HyperLinkToURL function
to start the default browser with a specified URL.

proc.png To hyperlink to a URL:

  1. Declare an instance or global variable
    of type Inet:

  2. Create the Internet service by calling the GetContextService function:

  3. Call the HyperLinkToURL function,
    passing the URL of the page to display when the browser starts:

Getting a URL

You call the Internet service’s GetURL function
to perform an HTTP Get, returning raw HTML for
a specified URL. This function returns the raw HTML using the InternetResult
object.

proc.png To perform an HTTP Get:

  1. Declare an instance or global variable
    of type Inet. Also declare an instance or global variable using
    the descendent InternetResult object as the datatype (n_ir_msgbox in
    this example):

  2. Create the Internet service by calling the GetContextService function:

  3. Create an instance of the descendent InternetResult
    object:

  4. Call the GetURL function, passing
    the URL of the page to be returned and a reference to the instance
    of the descendent InternetResult object:

    When the GetURL function completes, it
    calls the InternetData function defined in the
    descendent InternetResult object, passing the HTML for the specified
    URL.

Posting to a URL

You call the Internet service’s PostURL function
to perform an HTTP Post, sending data to a CGI,
ISAPI, or NSAPI program. This function returns the raw HTML using
the InternetResult object.

proc.png To perform an HTTP Post:

  1. Declare an instance or global variable
    of type Inet. Also declare an instance or global variable using
    the descendent InternetResult object as the datatype (n_ir_msgbox in
    this example):

  2. Create the Internet service by calling the GetContextService function:

  3. Create an instance of the descendent InternetResult
    object:

  4. Establish the arguments to the PostURL function:

  5. Call the PostURL function,
    passing the URL of the routine to be executed, the arguments, the
    header, an optional server port specification, and a reference to
    the instance of the descendent InternetResult object:

    When the PostURL function completes, it
    calls the InternetData function defined in the
    descendent InternetResult object, passing the HTML returned by the
    specified routine.

Using the InternetResult object

The GetURL and PostURL functions
both receive data in an InternetResult object. This object acts
as a buffer, receiving and caching the asynchronous data as it is
returned by means of the Internet. When all data is received, the InternetResult
object calls its InternetData function, which
you override to process the data as appropriate.

note.png Implement in descendants of InternetResult

You implement this feature by creating standard class user
objects of type InternetResult. In each of these descendent user
objects, define an InternetData function to process
the passed HTML as appropriate.

proc.png To implement a descendent InternetResult object:

  1. Create a standard class user object of
    type InternetResult.

  2. Declare a new user object function as follows:

    • Name

      InternetData

    • Access

      Public

    • Returns

      Integer

    • Argument name

      Data, passed by value

    • Argument datatype

      Blob

  3. Add code to the InternetData function
    that processes the returned HTML as appropriate. This example simply
    displays the HTML in a MessageBox:

Document get from Powerbuilder help
Thank you for watching.
Powerbuilder Documentation 12.5
PB Docs 125 Powerbuilder Application Techniques Powerbuilder Documentation Powerbuilder Documentation 12.5 Powerbuilder Documentation Older
August 9, 2023
Was this article helpful?
4
4
Subscribe
Notify of
guest
0 Comments
Oldest
Newest Most Voted
Inline Feedbacks
View all comments
0
Would love your thoughts, please comment.x
()
x