Java Fax - Submit a Binary File Using SendFax

This code sample demonstrates how to submit a Java fax with one attachment (binary file) to the InterFAX Web service, using the method SendFax.

SendFax also indicates whether the fax was submitted successfully -- the transaction ID (positive number) of the fax in the system indicates a successful transmission, where any other return values indicate a failure (for more details, see Web Service Return Codes).

The Java fax code sample copied below sends a binary, Java fax and indicates whether the submission was successful. This sample is also available as part of the ZIP file above (see the green 'Download' box), under the path interfaxJavaSamples > src > SendOneFileAttachment.


import net.interfax.outbound.Sendfax;
import net.interfax.outbound.SendfaxResponse;

public class SendOneFileAttachment {

    /******** Begin settings ********/
    static String USERNAME = "";       // Enter your Interfax username here
    static String PASSWORD = "";       // Enter your Interfax password here
    static String FAX_NUMBER = "";     // Enter the destination fax number here, e.g. +497116589658
    static String FILE_NAME  = "etc/sample.pdf";     // A file in your filesystem
    /******** End settings ********/

    public static void main(String[] anArgs) {
        try {
            net.interfax.outbound.InterFaxSoapStub theBinding = (net.interfax.outbound.InterFaxSoapStub)new net.interfax.outbound.InterFaxLocator().getInterFaxSoap();
            System.out.println("Sending Fax using Sendfax()");

            // Read file data into a byte[].
            byte[] fileData = transformToBytes(FILE_NAME);

            System.out.println("Sending Fax using sendFax().  Document size: " + fileData.length);

            Sendfax theParams = new Sendfax(USERNAME,
            SendfaxResponse theResponse = theBinding.sendfax(theParams);
            System.out.println("Sendfax() call returned with code: " + theResponse.getSendfaxResult());
        } catch (Exception e) {

     * Helper function to read a local file into a byte[].
    private static byte[] transformToBytes(String aFilename) throws Exception {
        if(null==aFilename) {
            throw new NullPointerException("aFilename is null");
        File theFile = new File(aFilename);
        if(!theFile.isFile()) {
            throw new IllegalArgumentException("Path doesn't represent a file: " + aFilename);
        if(!theFile.exists()) {
            throw new IllegalArgumentException("File not found: " + aFilename);
        InputStream theIs = new BufferedInputStream(new FileInputStream(theFile));
        ByteArrayOutputStream theRawData = new ByteArrayOutputStream();
        byte theBuffer[] = new byte[1024];
        int theBytesRead;
        try {
            while(( != -1) {
                if( theBytesRead < 1024 ) {
                    byte theSlice[] = new byte[theBytesRead];
                    System.arraycopy(theBuffer, 0, theSlice, 0, theBytesRead);
                } else {
        } finally {
        return theRawData.toByteArray();

Contact us today

Talk to a member of our team about the benefits InterFAX can bring to your organization's communications processes.

Contact us today