Skip to content

Commit 9503787

Browse files
committed
first java version, ported from kotlin
1 parent 748c046 commit 9503787

File tree

13 files changed

+609
-1
lines changed

13 files changed

+609
-1
lines changed

.gitignore

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
# Compiled class file
2+
*.class
3+
4+
# Log file
5+
*.log
6+
7+
# virtual machine crash logs, see http://www.java.com/en/download/help/error_hotspot.xml
8+
hs_err_pid*
9+
10+
# Gradle
11+
/.gradle
12+
13+
# Idea
14+
/.idea
15+
/build
16+
17+
# misc
18+
.DS_Store

README.md

Lines changed: 81 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,82 @@
11
# ipp-printjob-java
2-
A minimal ipp protocol implementation to submit a document to a printer
2+
A minimal ipp protocol implementation to submit a document to a printer.
3+
4+
### General
5+
6+
The printjob source code should be useful for use cases of driverless printing.
7+
Especially automated processes without user interaction should benefit from simple solutions like this.
8+
This code is not and will never become a full-fledged ipp implementation.
9+
I will provide more control over print jobs, monitoring of printers and print jobs in my other project
10+
[ipp-client-kotlin](https://github.com/gmuth/ipp-client-kotlin).
11+
12+
### Distribution
13+
14+
For the impatient [binary releases](https://github.com/gmuth/ipp-printjob-java/releases) are provided.
15+
Directory `demo` also contains the `printjob.jar` and a test script called `go` that submits a blank PDF to Apple's Printer Simulator.
16+
To avoid real printing, registered Apple developers can download
17+
[Additional Tools for Xcode](https://download.developer.apple.com/Developer_Tools/Additional_Tools_for_Xcode_11/Additional_Tools_for_Xcode_11.dmg)
18+
containing the Printer Simulator.
19+
20+
### Usage
21+
22+
The tool takes two arguments: *printer-uri* and *file-name*.
23+
The url scheme `ipp://` is not supported - use `http://` instead.
24+
If you don't know the printer uri try `ippfind`.
25+
26+
java -jar printjob.jar http://colorjet:631/ipp/printer A4-blank.pdf
27+
28+
send ipp request to http://colorjet:631/ipp/printer
29+
ipp version 1.1
30+
ipp response status: 0000
31+
group 01
32+
attributes-charset (47) = utf-8
33+
attributes-natural-language (48) = en
34+
group 02
35+
job-uri (45) = ipp://colorjet:631/jobs/352
36+
job-id (21) = 352
37+
job-state (23) = 3
38+
job-state-reasons (44) = none
39+
group 03
40+
41+
The equivalent java code is:
42+
43+
new PrintJob().printDocument(
44+
URI.create("http://colorjet:631/ipp/printer"),
45+
FileInputStream(File("A4-blank.pdf"))
46+
)
47+
48+
### Document Format
49+
50+
The operation attributes group does not include a value for `document-format` by default.
51+
This should be equivalent to `application/octet-stream` indicating the printer has to auto sense the document format.
52+
You have to make sure the printer supports the document format you send - PDF is usually a good option.
53+
If required by your printer, you can set the document format programmatically by adding it e.g. after the `printer-uri` attribute.
54+
55+
writeAttribute(dataOutputStream, 0x49, "document-format", "application/pdf");
56+
57+
### Issues
58+
59+
If you use an unsupported `printer-uri` you will get a response similar to this one:
60+
61+
send ipp request to http://localhost:8632/ipp/norona
62+
ipp version 1.1
63+
ipp status 0400
64+
group 01
65+
attributes-charset (47) = utf-8
66+
attributes-natural-language (48) = en
67+
status-message (41) = Bad printer-uri "http://localhost:8632/ipp/norona".
68+
group 03
69+
70+
You can use `ippfind` or `dns-sd -Z _ipp._tcp` (look at the rp value) to discover your printer's uri.
71+
If you have other issues contact me.
72+
73+
### Build
74+
75+
To build `printjob.jar` into `build/libs` you need an installed JDK.
76+
77+
./gradlew
78+
79+
### Community
80+
81+
I'd be happy to see this minimal ipp implementation being ported to all kinds of programming languages.
82+
On request I'll explain developers without experience in jvm based languages what the jvm runtime library is used for.

build.gradle

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
plugins {
2+
id 'java-library'
3+
}
4+
5+
repositories {
6+
jcenter()
7+
}
8+
9+
defaultTasks("clean", "build")
10+
11+
java {
12+
sourceCompatibility = JavaVersion.VERSION_1_9
13+
targetCompatibility = JavaVersion.VERSION_1_9
14+
}
15+
16+
jar {
17+
manifest {
18+
attributes 'Main-Class': 'ipp.PrintJob'
19+
}
20+
archivesBaseName = 'printjob'
21+
}

demo/A4-blank.pdf

1.27 KB
Binary file not shown.

demo/go

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
java -jar printjob.jar http://localhost:8632/printers/laser A4-blank.pdf

demo/printjob.jar

3.12 KB
Binary file not shown.

gradle/wrapper/gradle-wrapper.jar

57.3 KB
Binary file not shown.
Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,6 @@
1+
#Fri Mar 20 18:18:46 CET 2020
2+
distributionUrl=https\://services.gradle.org/distributions/gradle-6.0.1-all.zip
3+
distributionBase=GRADLE_USER_HOME
4+
distributionPath=wrapper/dists
5+
zipStorePath=wrapper/dists
6+
zipStoreBase=GRADLE_USER_HOME

gradlew

Lines changed: 183 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,183 @@
1+
#!/usr/bin/env sh
2+
3+
#
4+
# Copyright 2015 the original author or authors.
5+
#
6+
# Licensed under the Apache License, Version 2.0 (the "License");
7+
# you may not use this file except in compliance with the License.
8+
# You may obtain a copy of the License at
9+
#
10+
# https://www.apache.org/licenses/LICENSE-2.0
11+
#
12+
# Unless required by applicable law or agreed to in writing, software
13+
# distributed under the License is distributed on an "AS IS" BASIS,
14+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
15+
# See the License for the specific language governing permissions and
16+
# limitations under the License.
17+
#
18+
19+
##############################################################################
20+
##
21+
## Gradle start up script for UN*X
22+
##
23+
##############################################################################
24+
25+
# Attempt to set APP_HOME
26+
# Resolve links: $0 may be a link
27+
PRG="$0"
28+
# Need this for relative symlinks.
29+
while [ -h "$PRG" ] ; do
30+
ls=`ls -ld "$PRG"`
31+
link=`expr "$ls" : '.*-> \(.*\)$'`
32+
if expr "$link" : '/.*' > /dev/null; then
33+
PRG="$link"
34+
else
35+
PRG=`dirname "$PRG"`"/$link"
36+
fi
37+
done
38+
SAVED="`pwd`"
39+
cd "`dirname \"$PRG\"`/" >/dev/null
40+
APP_HOME="`pwd -P`"
41+
cd "$SAVED" >/dev/null
42+
43+
APP_NAME="Gradle"
44+
APP_BASE_NAME=`basename "$0"`
45+
46+
# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
47+
DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
48+
49+
# Use the maximum available, or set MAX_FD != -1 to use that value.
50+
MAX_FD="maximum"
51+
52+
warn () {
53+
echo "$*"
54+
}
55+
56+
die () {
57+
echo
58+
echo "$*"
59+
echo
60+
exit 1
61+
}
62+
63+
# OS specific support (must be 'true' or 'false').
64+
cygwin=false
65+
msys=false
66+
darwin=false
67+
nonstop=false
68+
case "`uname`" in
69+
CYGWIN* )
70+
cygwin=true
71+
;;
72+
Darwin* )
73+
darwin=true
74+
;;
75+
MINGW* )
76+
msys=true
77+
;;
78+
NONSTOP* )
79+
nonstop=true
80+
;;
81+
esac
82+
83+
CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
84+
85+
# Determine the Java command to use to start the JVM.
86+
if [ -n "$JAVA_HOME" ] ; then
87+
if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
88+
# IBM's JDK on AIX uses strange locations for the executables
89+
JAVACMD="$JAVA_HOME/jre/sh/java"
90+
else
91+
JAVACMD="$JAVA_HOME/bin/java"
92+
fi
93+
if [ ! -x "$JAVACMD" ] ; then
94+
die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
95+
96+
Please set the JAVA_HOME variable in your environment to match the
97+
location of your Java installation."
98+
fi
99+
else
100+
JAVACMD="java"
101+
which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
102+
103+
Please set the JAVA_HOME variable in your environment to match the
104+
location of your Java installation."
105+
fi
106+
107+
# Increase the maximum file descriptors if we can.
108+
if [ "$cygwin" = "false" -a "$darwin" = "false" -a "$nonstop" = "false" ] ; then
109+
MAX_FD_LIMIT=`ulimit -H -n`
110+
if [ $? -eq 0 ] ; then
111+
if [ "$MAX_FD" = "maximum" -o "$MAX_FD" = "max" ] ; then
112+
MAX_FD="$MAX_FD_LIMIT"
113+
fi
114+
ulimit -n $MAX_FD
115+
if [ $? -ne 0 ] ; then
116+
warn "Could not set maximum file descriptor limit: $MAX_FD"
117+
fi
118+
else
119+
warn "Could not query maximum file descriptor limit: $MAX_FD_LIMIT"
120+
fi
121+
fi
122+
123+
# For Darwin, add options to specify how the application appears in the dock
124+
if $darwin; then
125+
GRADLE_OPTS="$GRADLE_OPTS \"-Xdock:name=$APP_NAME\" \"-Xdock:icon=$APP_HOME/media/gradle.icns\""
126+
fi
127+
128+
# For Cygwin or MSYS, switch paths to Windows format before running java
129+
if [ "$cygwin" = "true" -o "$msys" = "true" ] ; then
130+
APP_HOME=`cygpath --path --mixed "$APP_HOME"`
131+
CLASSPATH=`cygpath --path --mixed "$CLASSPATH"`
132+
JAVACMD=`cygpath --unix "$JAVACMD"`
133+
134+
# We build the pattern for arguments to be converted via cygpath
135+
ROOTDIRSRAW=`find -L / -maxdepth 1 -mindepth 1 -type d 2>/dev/null`
136+
SEP=""
137+
for dir in $ROOTDIRSRAW ; do
138+
ROOTDIRS="$ROOTDIRS$SEP$dir"
139+
SEP="|"
140+
done
141+
OURCYGPATTERN="(^($ROOTDIRS))"
142+
# Add a user-defined pattern to the cygpath arguments
143+
if [ "$GRADLE_CYGPATTERN" != "" ] ; then
144+
OURCYGPATTERN="$OURCYGPATTERN|($GRADLE_CYGPATTERN)"
145+
fi
146+
# Now convert the arguments - kludge to limit ourselves to /bin/sh
147+
i=0
148+
for arg in "$@" ; do
149+
CHECK=`echo "$arg"|egrep -c "$OURCYGPATTERN" -`
150+
CHECK2=`echo "$arg"|egrep -c "^-"` ### Determine if an option
151+
152+
if [ $CHECK -ne 0 ] && [ $CHECK2 -eq 0 ] ; then ### Added a condition
153+
eval `echo args$i`=`cygpath --path --ignore --mixed "$arg"`
154+
else
155+
eval `echo args$i`="\"$arg\""
156+
fi
157+
i=`expr $i + 1`
158+
done
159+
case $i in
160+
0) set -- ;;
161+
1) set -- "$args0" ;;
162+
2) set -- "$args0" "$args1" ;;
163+
3) set -- "$args0" "$args1" "$args2" ;;
164+
4) set -- "$args0" "$args1" "$args2" "$args3" ;;
165+
5) set -- "$args0" "$args1" "$args2" "$args3" "$args4" ;;
166+
6) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" ;;
167+
7) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" ;;
168+
8) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" ;;
169+
9) set -- "$args0" "$args1" "$args2" "$args3" "$args4" "$args5" "$args6" "$args7" "$args8" ;;
170+
esac
171+
fi
172+
173+
# Escape application args
174+
save () {
175+
for i do printf %s\\n "$i" | sed "s/'/'\\\\''/g;1s/^/'/;\$s/\$/' \\\\/" ; done
176+
echo " "
177+
}
178+
APP_ARGS=`save "$@"`
179+
180+
# Collect all arguments for the java command, following the shell quoting and substitution rules
181+
eval set -- $DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS "\"-Dorg.gradle.appname=$APP_BASE_NAME\"" -classpath "\"$CLASSPATH\"" org.gradle.wrapper.GradleWrapperMain "$APP_ARGS"
182+
183+
exec "$JAVACMD" "$@"

0 commit comments

Comments
 (0)