This library is designed as a modular set of classes that can be used individually or in combination. It's a developer product made of individual classes and support DLLs that you can integrate into distributable applications of your own. Each of the components may have a set of dependencies that are described in the relevant help topics.
To find out about the many features available your best resources is the documentation that you are viewing now and peruse class reference. The class names should give you a good idea of purpose and features that are available.
The shareware version does not ship with source code and so how you load libraries works differently than in most examples. With the Shareware version you have to preload all components via wwClient.app:
*** Must load all libraries for shareware version DO wwClient *** Use your components loHttp = CREATEOBJECT("wwHttp")
More shareware version info: Using the West Wind Client Tools with the Shareware Version
Here are a few quick links for getting started with popular library components:
Most components in this library are provided as PRG files, with only 3 class libraries provided as VCXs. Additionally some components require external DLLs for their functionality. Code and external dependencies are noted in the help topic for each class at the end of the topic.
To use these components in your own application you can simply copy the dependencies into your own project folder. Make sure you include all dependencies. Alternately you can just reference the
wwClient configuration path and let your project pull in what it needs from there. If you get errors that certain components cannot be found you're missing a reference.
All PRG based classes are self-loading, meaning that you can
DO <ClassPrgFile>.prg to load the class and all of its dependencies. For example to load the
wwhttp class you can do it like this:
DO wwhttp && load library and dependencies
loHttp = CREATEOBJECT("wwhttp")
This loads wwHttp, wwUtils and wwApi PRG files and adds them to the Procedure stack.
Note that many of the PRG and VCX based components also require
wconnect.hto be accessible in order to compile. This file contains many constants that are used throughout the various components. Make sure
wconnect.hcan be found on the FoxPro path when compiling.
Each of the PRG based classes includes a header section that does
SET PROCEDURE TO itself and all of its dependencies. You can use
DO <ClassPrgFile>.prg either on application startup (recommended) to do this once in one place which is most efficient, or before every use explicitly which adds a little overhead. Note that either approaches is considerably faster than
NEWOBJECT(). It'll work but will be slower and won't resolve unloaded dependencies so we recommend you
DO <classfile>.prg to get libraries loaded.
Note that the shareware version doesn't ship source files and instead ships a
wconnect.app file that you can run that loads all libraries at once by running
DO WCONNECT.APP. You still need to make sure that the various DLLS can be found though so you still need to copy the files, or include them in your FoxPro Path.
*** Loads all libraries
DO wwClient && wwclient.app
loHttp = CREATEOBJECT("wwHttp")
lcHtml = loHttp.HttpGet("https://microsoft.com")
For more detailed info on using the shareware version, please see:
The VCX based class libraries have to be loaded explicitly as well as any dependencies they may have. For example to load wwBusiness you'd do:
SET PROCEDURE TO wwUtils ADDITIVE
SET CLASSLIB to wwSql ADDITIVE
loSql = CREATEOBJECT("wwSql")
Many components like wwDotnetBridge, wwSmtp, wwHttp, wwJsonSerializer have external dependencies on DLLs. If you're adding these components to your applications make sure you also add these DLLs to your project's distribution. DLLs must be discoverable in the current or FoxPro path.
If you're using any components that use DLL components like wwipstuff.dll, wwdotnetbridge.dll etc., it's possible that these files will be restricted due to Windows security policy. Any zip file downloaded from the Internet and unzipped automatically blocks DLL files. To fix you need to unblock the DLL files.
To do this on Windows 7-10, right click the file and click on the Unblock checkbox or (on Windows 7 and 8) the Unblock button.
To avoid this problem in distributed applications make sure you use an installer that runs under Administrator rights to install DLL files.
- wwIpStuff.dll - Required for many components and all .NET based components exposed
- wwDotnetBridge.dll - Required for any component that interfaces with .NET in some way like wwSmtp, MarkdownParser, wwJsonSerializer and many more
- Newtonsoft.Json.dll - .NET JSON Parser used for parsing JSON to objects and values
- RenciSoft.ssh.dll - .NET component used for FTPS support
- Markdig.dll - .NET Markdown Parser used in MarkdownParser
- dzip,dunzip - Win32 DLLs used for various Zip functions
At minimum we recommend that your application deploys wwipstuff.dll and wwdotnetbridge.dll since these are used for many of the components. The other dlls are usage specific and should be included on an as needed basis.
You can find out what's new in each new version released here:
This topic links to all that is new as well as breaking changes from previous updates.
The wwBusiness object comes with a new Business Object Wizard that lets you interactively build a new business object. To acces the Wizard:
which opens the Console, from which you can launch the Business Object Wizard.
Comment or report problem with topic