Tools to Capture and Convert the Web

Error Handling with Java

Java API

In order to enable developers to programmatically handle errors, when a error occurs the GrabzIt Java API throws a GrabzItException which contains a error code that directly maps to a error. How each error code maps to an error is indicated in the below table, this avoids the need to parse error messages.

An example of a GrabzItException exception using error codes to determine how to handle a error is shown below.

try
{
    GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret")%>");
    grabzIt.URLToImage("https://www.tesla.com");
    grabzIt.SaveTo("images/result.jpg");
}
catch(GrabzItException e)
{
    if (e.getCode() == ErrorCode.PARAMETERNOURL)
    {
        //Please enter a URL
    }
}

Error Code Lookup

Error Value Description Code
PARAMETERNOURL URL is missing 100
PARAMETERINVALIDURL Specified URL is invalid 101
PARAMETERNONEXISTANTURL Specified URL does not exist 102
PARAMETERMISSINGAPPLICATIONKEY Application key is missing 103
PARAMETERUNRECOGNISEDAPPLICATIONKEY Application key is not recognised 104
PARAMETERMISSINGSIGNATURE Signature is missing 105
PARAMETERINVALIDSIGNATURE Signature is invalid 106
PARAMETERINVALIDFORMAT Specified format is invalid 107
PARAMETERINVALIDCOUNTRYCODE Specified country code is invalid 108
PARAMETERDUPLICATEIDENTIFIER Specified identifier already exists 109
PARAMETERMATCHINGRECORDNOTFOUND Matching record not found 110
PARAMETERINVALIDCALLBACKURL Specified callback URL is invalid 111
PARAMETERNONEXISTANTCALLBACKURL Callback URL does not exist 112
PARAMETERIMAGEWIDTHTOOLARGE Specified image width too large 113
PARAMETERIMAGEHEIGHTTOOLARGE Specified image height too large 114
PARAMETERBROWSERWIDTHTOOLARGE Specified browser height too large 115
PARAMETERBROWSERHEIGHTTOOLARGE Specified browser width too large 116
PARAMETERDELAYTOOLARGE Specified delay too large 117
PARAMETERINVALIDBACKGROUND Invalid background parameter for PDF 118
PARAMETERINVALIDINCLUDELINKS Invalid include links parameter for PDF 119
PARAMETERINVALIDINCLUDEOUTLINE Invalid include outline parameter for PDF 120
PARAMETERINVALIDPAGESIZE Invalid PDF page size 121
PARAMETERINVALIDPAGEORIENTATION Invalid page orientation for PDF 122
PARAMETERVERTICALMARGINTOOLARGE Vertical margin for PDF too large 123
PARAMETERHORIZONTALMARGINTOOLARGE Horizontal margin for PDF too large 124
PARAMETERINVALIDCOVERURL Invalid cover URL for PDF 125
PARAMETERNONEXISTANTCOVERURL Specified cover URL for PDF does not exist 126
PARAMETERMISSINGCOOKIENAME Missing cookie name 127
PARAMETERMISSINGCOOKIEDOMAIN Missing cookie domain 128
PARAMETERINVALIDCOOKIENAME Invalid cookie name 129
PARAMETERINVALIDCOOKIEDOMAIN Invalid cookie domain 130
PARAMETERINVALIDCOOKIEDELETE Invalid cookie delete value 131
PARAMETERINVALIDCOOKIEHTTP Invalid cookie HTTP value 132
PARAMETERINVALIDCOOKIEEXPIRY Invalid cookie expiry 133
PARAMETERINVALIDCACHEVALUE Invalid cache value 134
PARAMETERINVALIDDOWNLOADVALUE Invalid download value 135
PARAMETERINVALIDSUPPRESSVALUE Invalid suppress value 136
PARAMETERMISSINGWATERMARKIDENTIFIER Missing watermark identifier 137
PARAMETERINVALIDWATERMARKIDENTIFIER Invalid watermark identifier 138
PARAMETERINVALIDWATERMARKXPOS Invalid watermark x position 139
PARAMETERINVALIDWATERMARKYPOS Invalid watermark y position 140
PARAMETERMISSINGWATERMARKFORMAT Watermark not found 141
PARAMETERWATERMARKTOOLARGE Watermark too large 142
PARAMETERMISSINGPARAMETERS Missing parameters 143
PARAMETERQUALITYTOOLARGE Quality parameter too large 144
PARAMETERQUALITYTOOSMALL Quality parameter too small 145
PARAMETERREPEATTOOSMALL Repeat parameter too small 149
PARAMETERINVALIDREVERSE Reverse parameter invalid 150
PARAMETERFPSTOOLARGE Frames per second parameter too large 151
PARAMETERFPSTOOSMALL Frames per second parameter too small 152
PARAMETERSPEEDTOOFAST Speed parameter too fast 153
PARAMETERSPEEDTOOSLOW Speed parameter too slow 154
PARAMETERINVALIDANIMATIONCOMBINATION The combination of the duration, FPS, width and height parameters is too large 155
PARAMETERSTARTTOOSMALL Start parameter too small 156
PARAMETERDURATIONTOOSMALL Duration parameter too small 157
PARAMETERNOHTML No HTML was specified 163
PARAMETERINVALIDTARGETVALUE Invalid target specified 165
PARAMETERINVALIDHIDEVALUE Invalid element to hide specified 166
PARAMETERINVALIDINCLUDEIMAGES Include links parameter for DOCX 167
PARAMETERINVALIDEXPORTURL Invalid export URL 168
PARAMETERINVALIDWAITFORVALUE Invalid wait for specified 169
PARAMETERINVALIDTRANSPARENTVALUE Invalid transparent specified 170
PARAMETERINVALIDENCRYPTIONKEY Invalid encryption key specified 171
PARAMETERINVALIDNOADS Invalid advert value specified 172
PARAMETERINVALIDPROXY Invalid HTTP proxy settings provided 173
PARAMETERINVALIDNONOTIFY Invalid cookie notification value specified 174
PARAMETERINVALIDHD Invalid high definition value specified 176
PARAMETERINVALIDMEDIATYPE Invalid media type value specified 177
PARAMETERINVALIDPASSWORD Invalid password value specified 178
PARAMETERINVALIDMERGE Invalid merge identifier specified 179
PARAMETERINVALIDCLICKVALUE Invalid CSS selector to click specified 180
NETWORKSERVEROFFLINE Server offline 200
NETWORKGENERALERROR General network error 201
NETWORKDDOSATTACK Distributed Denial of Service attack 202
RENDERINGERROR General rendering error 300
RENDERINGMISSINGSCREENSHOT Missing screenshot 301
GENERICERROR General error 400
UPGRADEREQUIRED Upgrade required 500
FILESAVEERROR File save error 600
FILENONEXISTANTPATH File path does not exist 601