API:FAQ:New Wrapper

June 2023 - New Wrapper and Sample Project Release

As of June 2023, Melissa has released new wrapper interfaces with a console-based sample program for all DQT Suite objects. We recommend that you start using the new Wrapper interface to leverage all of the new features.

Note, all of our previous Wrapper Interfaces will still work as intended, but will not include new methods that may have been added with the June 2023 release.

Please use the Powershell (Windows) or Bash (Linux) scripts to generate the Wrapper Library located within the github links below. The new sample projects and wrapper interfaces can be found using the hyperlinks provided below.

Programming Language Support

The following languages are supported with the new wrapper interface and sample projects:

• Java
• DotNet
• Python3

The following languages are no longer supported with the new wrapper interface and sample projects:

• Perl
• PHP
• Ruby
• SQLServer
• PLSQL

License String

The new scripts will prompt you for a license string. You may have stored this as an environment variable (MD_LICENSE).

To obtain a license string and get started, please contact a sales representative by:

• Calling 1-800-MELISSA
• Emailing Sales@melissa.com

Melissa Updater

By default, the scripts use an additional tool called MelissaUpdater. MelissaUpdater will download the latest release library and data files for each object.

Note, you can disable either the library or data file download by modifying the script prior to running the script.

Programming Language Notes

Java

Quick Notes

• The Jar file is no longer required but can be generated with the following commands:

javac com/melissadata/*.java

• This command compiles the java files inside the com/melissadata folder

jar cvf {OUTPUTNAME}.jar com

• This command will zip up all the files inside the com folder. {OUTPUTNAME} should be renamed as mdAddr.jar, mdEmail.jar, mdPhone.jar, or mdName.jar

• If a jar file is required by your application, replace both the new jar file and the wrapper library (.dll or .so).

Wrapper

• https://github.com/MelissaData/AddressObject-Java-Wrappers
• https://github.com/MelissaData/EmailObject-Java-Wrappers
• https://github.com/MelissaData/NameObject-Java-Wrappers
• https://github.com/MelissaData/PhoneObject-Java-Wrappers

Sample Projects (Windows)

• https://github.com/MelissaData/AddressObject-Java
• https://github.com/MelissaData/EmailObject-Java
• https://github.com/MelissaData/NameObject-Java
• https://github.com/MelissaData/PhoneObject-Java

Sample Projects (Linux)

• https://github.com/MelissaData/AddressObject-Java-Linux
• https://github.com/MelissaData/EmailObject-Java-Linux
• https://github.com/MelissaData/NameObject-Java-Linux
• https://github.com/MelissaData/PhoneObject-Java-Linux

Dotnet

Quick Notes

• We no longer generate wrapper libraries for DotNet and DotNetCore.
• Instead, we provide a .cs file that can be included in the project and called directly from the code.

Wrapper

• https://github.com/MelissaData/AddressObject-Dotnet-Wrappers
• https://github.com/MelissaData/EmailObject-Dotnet-Wrappers
• https://github.com/MelissaData/NameObject-Dotnet-Wrappers
• https://github.com/MelissaData/PhoneObject-Dotnet-Wrappers

Sample Projects (Windows)

• https://github.com/MelissaData/AddressObject-Dotnet
• https://github.com/MelissaData/EmailObject-Dotnet
• https://github.com/MelissaData/NameObject-Dotnet
• https://github.com/MelissaData/PhoneObject-Dotnet

Sample Projects (Linux)

• https://github.com/MelissaData/AddressObject-Dotnet-Linux
• https://github.com/MelissaData/EmailObject-Dotnet-Linux
• https://github.com/MelissaData/NameObject-Dotnet-Linux
• https://github.com/MelissaData/PhoneObject-Dotnet-Linux

Python3

Quick Notes

• We no longer generate wrapper library for Python.
• Instead, we provide a .py file that can be included in the project and called directly from the Python code.

Wrapper

• https://github.com/MelissaData/AddressObject-Python3-Wrappers
• https://github.com/MelissaData/EmailObject-Python3-Wrappers
• https://github.com/MelissaData/NameObject-Python3-Wrappers
• https://github.com/MelissaData/PhoneObject-Python3-Wrappers

Sample Projects (Windows)

• https://github.com/MelissaData/AddressObject-Python3
• https://github.com/MelissaData/EmailObject-Python3
• https://github.com/MelissaData/NameObject-Python3
• https://github.com/MelissaData/Phonebject-Python3

Sample Projects (Linux)

• https://github.com/MelissaData/AddressObject-Python3-Linux
• https://github.com/MelissaData/EmailObject-Python3-Linux
• https://github.com/MelissaData/NameObject-Python3-Linux
• https://github.com/MelissaData/Phonebject-Python3-Linux