Documentation

Overview

The advanced configuration gives the experienced .NET programmer (possibly a business service developer or front-end developer) flexibility and control in configuring system architecture based on differing needs. For example, with the WebFigureService and the web page on different servers, the administrator can optimally position the MATLAB^® Runtime (for performance reasons) or place customer-sensitive customer data behind a security firewall, if needed.

In summary, the advanced configuration offers more choices and adaptability for the user more familiar with web environments and related technology, as illustrated by the following graphics.

This section describes various ways to customize the basic WebFigures implementation described in Quick Start Implementation of WebFigures.

Manually Installing WebFigureService

WebFigureService is essentially a set of HTTP handlers that can service requests sent to an instance of Internet Information Service (IIS). There are occasions when you may want to install WebFigureService manually. For example:

When you dragged the GUI control for WebFigures onto the web page in Quick Start Implementation of WebFigures, you automatically installed WebFigureService in the web application file web.config.

To install WebFigureService manually:

Retrieving Multiple WebFigures From a Component

If your deployed component returns several WebFigures, then you have to make additional modifications to your code.

MATLAB sees a WebFigure the same way it see a MWStructArray. WebFigure constructors accept a WebFigure, an MWArray, or an MWStructArray as inputs.

Use the following examples as guides, depending on what type of functions you are working with.

using MyComponent;
using MathWorks.MATLAB.NET.WebFigures;

public class
{
        protected void Page_Load(object sender, EventArgs e)
        {
                MyComponentclass myDeployedComponent =
                   new MyComponentclass();

                WebFigureControl1.WebFigure =
                   new WebFigure(myDeployedComponent.getPlot());
        }
}

Imports MyComponent
Imports MathWorks.MATLAB.NET.WebFigures

Class
        Protected Sub Page_Load(ByVal sender As Object,
                                ByVal e As System.EventArgs)
                                Handles Me.Load
                Dim myDeployedComponent As _
                    New MyComponentclass()

                WebFigureControl1.WebFigure = _
                    New WebFigure(myDeployedComponent.getPlot())
        End Sub
End Class

using MyComponent;
using MathWorks.MATLAB.NET.WebFigures;

public class
{
        protected void Page_Load(object sender, EventArgs e)
        {
                MyComponentclass myDeployedComponent =
                        new MyComponentclass();

		 //If the function returns an array with 4 WebFigures 
		 //  in it and takes in no inputs.
		 MWArray[] outputs = myDeployedComponent.getPlot(4);	
		
                WebFigureControl1.WebFigure =
                        new WebFigure(outputs[0]);

		 WebFigureControl2.WebFigure =
                        new WebFigure(outputs[1]);

		 WebFigureControl3.WebFigure =
                        new WebFigure(outputs[2]);

  		 WebFigureControl4.WebFigure =
                        new WebFigure(outputs[3]);
        }
}

Imports MyComponent
Imports MathWorks.MATLAB.NET.WebFigures

Class
        Protected Sub Page_Load(ByVal sender As Object,
                                ByVal e As System.EventArgs)
                                Handles Me.Load
                Dim myDeployedComponent As _
                        New MyComponentclass()

		 Dim outputs as MWArray() = _
			myDeployedComponent.getPlot(4)
 		
                WebFigureControl1.WebFigure = _
                        New WebFigure(outputs(0))

                WebFigureControl2.WebFigure = _
                        New WebFigure(outputs(1))

                WebFigureControl3.WebFigure = _
                        New WebFigure(outputs(2))

                WebFigureControl4.WebFigure = _
                        New WebFigure(outputs(3))
        End Sub
End Class

Attaching a WebFigure

After you have manually installed WebFigureService, the server where it is installed is ready to receive requests for any WebFigure information. In the Quick Start, WebFigureService uses the session cache built into IIS to retrieve a WebFigure, per user, and display it. Since a WebFigureControl isn't being used in this case, you need to manually set up the WebFigureService and attach the WebFigure. Add the code supplied in this section to attach a WebFigure of your choosing.

This method of setting up WebFigureService and attaching the figure manually is very useful in the following situations:

There are a number of ways to attach a WebFigure to a scope, depending on state (note that these terms follow standard industry definitions and usage):

Add the following code to manually attach the WebFigure, based on whether you are using C# or Visual Basic^®:

Setting Up WebFigureControl for Remote Invocation

After you drag a WebFigureControl onto a page, as in Quick Start Implementation of WebFigures, you either assign the WebFigure property or set the Remote Invocation properties, depending on how the figure will be used.

The procedure in this section allows you to tell WebFigureControl to reference a WebFigure that has been manually attached to a WebFigureService on a remote server or cluster of remote servers. This allows you to use the custom control, yet the resources of WebFigureService are running on a remote server to maximize performance.

Getting an Embeddable String That References a WebFigure Attached to a WebFigureService

From any server, you can use the GetHTMLEmbedString API to get a string that can be embedded onto a page, if you followed the procedures Manually Installing WebFigureService in Attaching a WebFigure.

To do so, use the following optional parameters and code snippets (or something similar, depending on your implementation). For information on the differences between session, application, and cache scopes, see Attaching a WebFigure.

Improving Processing Times for JavaScript Using Minification

This application uses JavaScript^® to perform most of its AJAX functionality. Because JavaScript runs in the client browser, it must all be streamed to the client computer before it can execute. To improve this process, you use a standard JavaScript minification algorithm to remove comments and white space in the code. This feature is enabled by default. To disable it, create an environment variable called mathworks.webfigures.disableJSMin and set its value to true.

Using Global Assembly Cache (Global.asax) to Create WebFigures at Server Start-Up

In ASP.NET there is a special type of object you can add called a Global Assembly Cache, also known by the name Global.asax.

Global.asax classes have methods that are called at various times in the IIS life cycle, such as Application_Start and Application_End. These methods get called respectively when the server is first started and when the server is being shut down.

As seen in Quick Start Implementation of WebFigures, the default behavior for a WebFigureControl is to store data in the Session cache on the server. In other words, each user that accesses a page using a WebFigureControl has an individual instance of that WebFigure in the cache. This is useful if each user gets specific data, but resources can be wasted in situations where all users are accessing the same WebFigures.

Therefore, in order to maximize available resources, it makes sense to move WebFigure code for commonly used figures into the Application_Start method of the Global.asax. In the following example, code written in the web page initialization section of Attaching a WebFigure is moved into a Global.asax method as follows:

 C#

void Application_Start(object sender, EventArgs e) 
{ 
    // Code that runs on application startup 
    MyComponentclass myDeployedComponent = 
        new MyComponentclass(); 

    Application["ApplicationStateWebFigure"] = 
        new WebFigure(myDeployedComponent.getPlot()); 

    //Or 

    Cache["CacheStateWebFigure"] = 
        new WebFigure(myDeployedComponent.getPlot()); 
} 

 Visual Basic

Sub Application_Start
           (ByVal sender As Object, ByVal e As EventArgs) 
        ' Code that runs on application startup 
        Dim myDeployedComponent As _ 
            New MyComponentclass() 


        Application("ApplicationStateWebFigure") = _ 
            New WebFigure(myDeployedComponent.getPlot()) 

        'Or 

        Cache("CacheStateWebFigure") = _ 
            New WebFigure(myDeployedComponent.getPlot()) 
    End Sub