Difference between revisions of "API:FAQ:New Wrapper"

From Melissa Data Wiki
Jump to navigation Jump to search
Line 30: Line 30:


===Melissa Updater===
===Melissa Updater===
By default, the scripts use an additional tool called '''MelissaUpdater'''. '''Melissa Updater''' will download the latest release library and data files for each object.
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.
Note, you can disable either the library or data file download by modifying the script prior to running the script.
Line 37: Line 37:
==Programming Language Notes==
==Programming Language Notes==
<h3 class="productfield">Java</h3>
<h3 class="productfield">Java</h3>
;Quick Notes:
:;Quick Notes:


*The Jar file is no longer required but can be generated with the following commands:
:*The Jar file is no longer required but can be generated with the following commands:
**<pre>javac com/melissadata/*.java</pre>
::<code>javac com/melissadata/*.java</code>
***This command compiles the java files inside the com/melissadata folder
::*This command compiles the java files inside the <code>com/melissadata</code> folder
**<code>jar cvf {OUTPUTNAME}.jar com</code>
***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
::<code>jar cvf {OUTPUTNAME}.jar com</code>
::*This command will zip up all the files inside the com folder. <code>{OUTPUTNAME}</code> should be renamed as <code>mdAddr.jar</code>, <code>mdEmail.jar</code>, <code>mdPhone.jar</code>, or <code>mdName.jar</code>
:*If a '''jar''' file is required by your application, replace '''both''' the new jar file and the wrapper library (.dll or .so).


*https://github.com/MelissaData/AddressObject-Java-Wrappers
:;Wrapper
*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-Wrappers
:*https://github.com/MelissaData/EmailObject-Java-Wrappers
:*https://github.com/MelissaData/NameObject-Java-Wrappers
:*https://github.com/MelissaData/PhoneObject-Java-Wrappers


*https://github.com/MelissaData/AddressObject-Java
:;Sample Projects (Windows)
*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
:*https://github.com/MelissaData/EmailObject-Java
:*https://github.com/MelissaData/NameObject-Java
:*https://github.com/MelissaData/PhoneObject-Java


*https://github.com/MelissaData/AddressObject-Java-Linux
:;Sample Projects (Linux)
*https://github.com/MelissaData/EmailObject-Java-Linux
 
*https://github.com/MelissaData/NameObject-Java-Linux
:*https://github.com/MelissaData/AddressObject-Java-Linux
*https://github.com/MelissaData/PhoneObject-Java-Linux
:*https://github.com/MelissaData/EmailObject-Java-Linux
:*https://github.com/MelissaData/NameObject-Java-Linux
:*https://github.com/MelissaData/PhoneObject-Java-Linux




<h3 class="productfield">Dotnet</h3>
<h3 class="productfield">Dotnet</h3>
;Quick Notes:
:;Quick Notes:


*We no longer generate wrapper libraries for DotNet and DotNetCore.
:*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.
:*Instead, we provide a .cs file that can be included in the project and called directly from the code.


;Wrapper
:;Wrapper


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


;Sample Projects (Windows)
:;Sample Projects (Windows)


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


;Sample Projects (Linux)
:;Sample Projects (Linux)


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




<h3 class="productfield">Python3</h3>
<h3 class="productfield">Python3</h3>
;Quick Notes:
:;Quick Notes:


*We no longer generate wrapper library for Python.
:*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.
:*Instead, we provide a .py file that can be included in the project and called directly from the Python code.


;Wrapper
:;Wrapper


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


;Sample Projects (Windows)
:;Sample Projects (Windows)


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


;Sample Projects (Linux)
:;Sample Projects (Linux)


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

Revision as of 00:44, 21 July 2023

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:

The following languages are no longer supported:

  • 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
Sample Projects (Windows)
Sample Projects (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
Sample Projects (Windows)
Sample Projects (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
Sample Projects (Windows)
Sample Projects (Linux)