GoogleCloudPrint - GitLite

KO | EN

gitlite — search

#javascript #ai #typescript #golang #machine-learning #rust #linux #java #awesome #vue #security #pytorch #openai #open-source

GoogleCloudPrint

(★ 49)

Google Cloud Print (GCP) API for Java

파일 탐색기

최종 버전 다운로드 (.zip)

- pom.xml
- pom.xml
.gitignore
LICENSE
pom.xml
README.md

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/jittagornp/GoogleCloudPrint

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd GoogleCloudPrint

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Maven (Java)

보통 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
JDK (Java) Java 프로젝트를 빌드/실행하려면 필요합니다.
Maven mvn 명령어를 쓰기 위한 빌드 도구입니다.

cd google-cloudprint-api

이 프로젝트의 관련 파일이 하위 폴더 안에 있어서, 먼저 그 폴더로 이동합니다.

mvn clean install

Maven으로 의존성 설치와 빌드를 진행합니다.

✅ BUILD SUCCESS 메시지가 뜨면 성공입니다. target/ 폴더에 결과물이 생성됩니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Google Cloud Print

> Google Cloud Print (GCP) API for Java

Document : [https://developers.google.com/cloud-print/](https://developers.google.com/cloud-print/)

# About Capabilities

There are two ways to do that:

1. Load printer capabilities and create an XML(XPS format) file using Windows API. Ex.: Using "PrintQueue" class --> GetPrintCapabilitiesAsXml.WriteTo(file)
2. Obtaining the PPD file of the PostScript printer.
Uploading one of these files, GCP was able to understand the printer capabilities.
  
Recommended from **João Vianey** (Google Cloud Print developer)
Thank you very much.

# Example

### Connect to google cloud print

```java  
String email = "YOUR_GOOGLE_EMAIL";
String password = "YOUR_GOOGLE_PASSWORD";

GoogleCloudPrint cloudPrint = new GoogleCloudPrint();

//connect to google cloud print
cloudPrint.connect(email, password, "geniustree-cloudprint-1.0");
```
### Disconnect from google cloud print
```java
cloudPrint.disconnect();
```

### Register printer
```java
// create and setup printer

RegisterPrinterResponse response = cloudPrint.registerPrinter(printer);
```

and

```java
InputStream inputStream = null;
try {
    //URL ppdURL = Example.class.getResource("/ppd/ADIST5CS.PPD");
    URL xpsURL = Example.class.getResource("/xml/XPSCapabilities.xml");
    
    File capabilitiesFile = new File(xpsURL.getPath());
    inputStream = new FileInputStream(capabilitiesFile);

/*
    * require
    * - printer name
    * - display name
    * - proxy
    * - capabilities 
    * - defaults
    * - tag
    * - status
    * - description
    * - capsHash
    */

Printer printer = new Printer();
    printer.setName("Test Printer");
    printer.setDisplayName("Test Printer");
    printer.setProxy("pamarin");
    Set<String> tags = new HashSet<String>();
    tags.add("test");
    tags.add("register");
    printer.setTags(tags);

String capsHash = DigestUtils.sha512Hex(inputStream);
    printer.setCapsHash(capsHash);
    printer.setStatus("REGISTER");
    printer.setDescription("test register printer");
    printer.setCapabilities(capabilitiesFile);
    printer.setDefaults(capabilitiesFile);

RegisterPrinterResponse response = cloudPrint.registerPrinter(printer);
    if (!response.isSuccess()) {
        LOG.debug("message = > {}", response.getMessage());
        return;
    }
    
    for (Printer print : response.getPrinters()) {
        LOG.debug("printer response => {}", print);
    }
} catch (IOException ex) {
    LOG.warn(null, ex);
} catch (CloudPrintException ex) {
    LOG.warn(null, ex);
} finally {
    if (inputStream != null) {
        try {
            inputStream.close();
        } catch (IOException ex) {
            LOG.warn(null, ex);
        }
    }
}
```
### Job listener

listener job from google talk notification

```java
cloudPrint.addJobListener(new JobListener() {
    //
    @Override
    public void onJobArrive(Job job, boolean success, String message) {
    
        //do something ...
    
    }
});    
```

and

```java
cloudPrint.addJobListener(new JobListener() {
    //
    @Override
    public void onJobArrive(Job job, boolean success, String message) {
        if (success) {
            try {
                LOG.debug("job arrive => {}", job);
                File directory = new File("C:\\temp\\cloudPrint");
                if (!directory.exists()) {
                  directory.mkdirs();
                }

//download print file from google cloud print     
                String fileName = FilenameUtils.removeExtension(job.getTitle()) + ".pdf";
                File outputFile = new File(directory, fileName);
                 
                cloudPrint.downloadFile(job.getFileUrl(), outputFile);
        
 
 
                //do something...
                
                
                //get job information or printing option such as
                // - document collate 
                // - page output color 
                // - page orientation 
                // - page media size 
                // - duplex page 
                // - copies document
                // ...
                // response is XML format
                String ticketResponse = cloudPrint.getJobTicket(job.getTicketUrl());
                LOG.debug("ticketResponse => {}", ticketResponse);

//update job status
                ControlJobResponse response = cloudPrint.controlJob(job.getId(), JobStatus.DONE, 200, "success.");
                LOG.debug("control job response=> {}", response.isSuccess() + ", " + response.getMessage());
            } catch (CloudPrintException ex) {
                LOG.warn(null, ex);
            }
        } else {
            LOG.info("job arrive error message => {}", message);
        }
    }
});
```

### Submit job

send job to google cloud print

```java
//create and setup job

SubmitJobResponse response = cloudPrint.submitJob(submitJob);
```

and

```java
//send job to target printer
//printer id = "810c1d39-981f-cd36-5fdc-951ea5e62613"

InputStream jsonInputStream = null;
InputStream imageInputStream = null;
try {
    jsonInputStream = Example.class.getResourceAsStream("/json/submitJobTicketRequest.json");
    imageInputStream = Example.class.getResourceAsStream("/testImage.png");
    byte[] content = IOUtils.toByteArray(imageInputStream);

//get job option from json file
    //such as  
    // - document collate 
    // - page output color 
    // - page orientation 
    // - page media size 
    // - duplex page 
    // - copies document
    // ...
    String jsonTicket = IOUtils.toString(jsonInputStream);
    Ticket ticket = gson.fromJson(jsonTicket, Ticket.class);

String json = gson.toJson(ticket);
    LOG.debug("json => {}", json);
    
    //create job
    SubmitJob submitJob = new SubmitJob();
    submitJob.setContent(content);
    submitJob.setContentType("image/png");
    submitJob.setPrinterId("810c1d39-981f-cd36-5fdc-951ea5e62613"); //*****
    submitJob.setTag(Arrays.asList("koalar", "hippo", "cloud"));
    submitJob.setTicket(ticket);
    submitJob.setTitle("testImage.png");

//send job
    SubmitJobResponse response = cloudPrint.submitJob(submitJob);
    LOG.debug("submit job response => {}", response.isSuccess() + "," + response.getMessage());
    LOG.debug("submit job id => {}", response.getJob().getId());

//control job (update job)
    //...
    //...
} catch (Exception ex) {
    LOG.warn(null, ex);
} finally {
    if (jsonInputStream != null) {
        try {
            jsonInputStream.close();
        } catch (IOException ex) {
            LOG.warn(null, ex);
        }
    }

if (imageInputStream != null) {
        try {
            imageInputStream.close();
        } catch (IOException ex) {
            LOG.warn(null, ex);
        }
    }
}
```
### Delete job

```java
//jobId generate by google cloud print

DeleteJobResponse response = cloudPrint.deleteJob(jobId);
LOG.debug("delete job response => {}", response.isSuccess() + ", " + response.getMessage());
```

### Update printer informaton

```java
//printer id = "a1dbe503-eb96-6d26-dc7b-a290a1cfaf3b"

Printer printer = new Printer();
printer.setId("a1dbe503-eb96-6d26-dc7b-a290a1cfaf3b");
printer.setName("Adobe PDF2"); //set new name
printer.setDisplayName("Adobe PDF2");

UpdatePrinterResponse response = cloudPrint.updatePrinter(printer);
LOG.debug("update printer response => {}", response.isSuccess() + ", " + response.getMessage());
```
### Search printer

```java
//search all printers which name is "fax"
//PrinterStatus.ALL is all printer status 
// - ONLINE
// - UNKNOWN
// - OFFLINE
// - DORMANT

SearchPrinterResponse response = cloudPrint.searchPrinter("fax", PrinterStatus.ALL);
if (!response.isSuccess()) {
    LOG.debug("message = > {}", response.getMessage());
    return;
}

for (Printer printer : response.getPrinters()) {
    LOG.debug("printer => {}", printer);
}
```

### Get printer information

```java
//printer id = "dc6929f5-8fdc-5228-1e73-c9dee3298445"

PrinterInformationResponse response = cloudPrint.getPrinterInformation("dc6929f5-8fdc-5228-1e73-c9dee3298445");
if (!response.isSuccess()) {
    LOG.debug("message = > {}", response.getMessage());
    return;
}

for (Printer printer : response.getPrinters()) {
    LOG.debug("printer information response => {}", printer);
}
```

### Update job status (Control  job)

```java
//parameter
//job id : get from subscribe job (generate by google cloud print)
//job status : 
// - QUEUED
// - IN_PROGRESS
// - DONE
// - ERROR
//job code : get from printer
//job message : get from printer

ControlJobResponse response = cloudPrint.controlJob(job.getId(), JobStatus.IN_PROGRESS, 100, "PROGRESSING.");
LOG.debug("control job response=> {}", response.isSuccess() + ", " + response.getMessage());
```

### Get job (print job)

Get all jobs

```java
JobResponse response = cloudPrint.getJobs();
if (!response.isSuccess()) {
    LOG.debug("message = > {}", response.getMessage());
    return;
}

for (Job job : response.getJobs()) {
    LOG.debug("job response => {}", job);
}
```

Get job of printer

```java
//printer id = "dc6929f5-8fdc-5228-1e73-c9dee3298445"

JobResponse response = cloudPrint.getJobOfPrinter("dc6929f5-8fdc-5228-1e73-c9dee3298445");
if (!response.isSuccess()) {
    LOG.debug("message = > {}", response.getMessage());
    return;
}

for (Job job : response.getJobs()) {
    LOG.debug("job response => {}", job);
}
```

### Delete printer

```java
//printer id = "12280cbe-6486-2c98-c65a-22083bd18b5b"

DeletePrinterResponse response = cloudPrint.deletePrinter("12280cbe-6486-2c98-c65a-22083bd18b5b");
LOG.debug("delete printer response => {}", response.isSuccess() + ", " + response.getMessage());
```

### Share printer

```java
//printer id = "dc6929f5-8fdc-5228-1e73-c9dee3298445"
//target email = "jittagorn@geniustree.co.th"

SharePrinterResponse response = cloudPrint.sharePrinter("dc6929f5-8fdc-5228-1e73-c9dee3298445", "jittagorn@geniustree.co.th");
LOG.debug("share printer message => {}", response.isSuccess() + ", " + response.getMessage());
```