サンプルコードで身につける: コマンド行の読み方: $ とコマンドとオプションと引数

用語 | 一言で
  手元では: 実際のコマンド行での姿
  近いもの: Node のコマンド行で近いもの
 
コマンド行 | 道具の名前と、道具への指示を並べた1行
  手元では: $ java -cp out app.Main
  近いもの: $ node dist/main.js
 
コマンド | 道具の名前。行の最初の語
  手元では: java、javac、jar、javap、mvn、ant
  近いもの: node、npm、tsc
 
オプション | 道具への指示。- や -- で始まる
  手元では: javap -p の -p、jar --create の --create
  近いもの: tsc --project tsconfig.json の --project
 
値を取るオプション | 直後の語を値として受け取る
  手元では: -cp out、-d out、--file app.jar
  近いもの: tsc --project tsconfig.json
      (--project の値がファイル名)
 
引数 | 道具が扱う対象。オプション以外の語
  手元では: java app.Main の app.Main
  近いもの: node dist/main.js の dist/main.js
 
プログラムへの引数 | 道具ではなく、道具が動かす
  プログラムが受け取る語。java では、クラス名や
  JAR 名より後ろに書く
  手元では: java -jar demo.jar --server.port=8084
      の --server.port=8084
  近いもの: 対応を確かめていない
 
サブコマンド | 道具の中の、どの仕事をするかを選ぶ語
  (呼び名は道具ごとに違う。jar では操作、
   Maven ではフェーズやゴール)
  手元では: docker history の history、jar tf の t
      mvn package の package
  近いもの: npm run build の run
      (npm の文書は run を command と呼ぶ)
 
短い形と長い形 | 同じ指示の2通りの書き方
  手元では: -cp と --class-path
      jar tf と jar --list --file
  近いもの: 対応を確かめていない
 
続け書き | 1文字のオプションを続けて書いた形
  手元では: jar tf app.jar(t と f の2つ)
      curl -si(-s と -i の2つ)
  近いもの: 対応を確かめていない
 
出力 | コマンドが表示した行。$ が付かない
  手元では: Hello, world! sum=5
  近いもの: 同じ
 
終了コード | コマンドが終わるときに返す数
  0 が成功、0 以外が失敗
  手元では: ログの [exit 0] や [exit 1]
      (実験用のスクリプトが書き足した行)
  近いもの: 同じ(シェルの決まり)

コマンド | 何の道具か
 
# JDK に入っているもの
java | Java のプログラムを起動する(JVM を立ち上げる)
javac | .java から .class を作るコンパイラ
jar | .class をまとめて JAR を作る。JAR の中を見る
javap | .class の中身を、人が読める形で表示する
jarsigner | JAR に署名を付ける、署名を確かめる
  (このコースでは名前だけ出る。jshell、jlink、
   keytool なども、bin の一覧の中に名前だけ出る)
 
# ビルドツール(JDK には入っていない)
mvn | Maven を実行する
./mvnw | Maven のラッパー
  決まった版の Maven を取ってきて実行するスクリプト
ant | Ant を実行する
./gradlew | Gradle のラッパー
  ($ gradle ... と打つ行は、このコースには出ない)
 
# 別に入れる道具(JDK のものではない)
curl | URL を指定して、サーバとデータをやり取りする
  -i は応答のヘッダも表示、-s は進み具合などを出さない
  -si は、その2つの続け書き
wget | curl と同じく、URL からデータを取ってくる道具
  (名前だけ出る)
unzip | zip の中身を一覧する、取り出す
  (JAR は zip 形式なので、JAR にも使える)
  -l は一覧、-v は詳しい一覧、-p は中身を画面に出す
tree | フォルダの中身を、木の形で一覧する
  tree -a は、隠しファイル(. で始まる名前)も出す
xxd | ファイルの中身を16進数で表示する
strace | プログラムが OS に頼んだ処理を記録する(Linux)
docker | Docker を操作する
  docker history はイメージの履歴、docker images は一覧
native-image | GraalVM に入っているコマンド
  Java のアプリを実行ファイルに前もってコンパイルする
  (後のレッスンで扱う)
 
# OS の一般的な道具(JDK でも Spring でもない)
ls | フォルダの中身を一覧する
  ls -l は大きさなども出す、ls -a は隠しファイルも出す
  このコースでは: できたファイルを確かめる
cd | 今いるフォルダを移る
find | フォルダの階層から、ファイルを探して一覧する
  -type f はファイルだけ、-name は名前で絞る
  このコースでは: ソースや .class の一覧を出す
grep | 指定した文字を含む行だけを出す
  -v は含まない行を出す、-c は行数を出す
sort | 行を並べ替える(一覧の順をそろえる)
wc | 数える。-l は行数(一覧の件数を数える)
head | 先頭の行だけ出す。head -1 は1行だけ
cat | ファイルの中身を表示する
echo | 後ろに書いた文字を表示する
awk | 行を空白で区切り、指定した列だけ出すなどの加工
  このコースでは: ls -l から大きさと名前の列を出す
diff | 2つのファイルの違う行を表示する
mkdir | フォルダを作る。-p は途中のフォルダも作る
cp | ファイルをコピーする
rm | ファイルを消す
touch | ファイルの更新時刻を今にする
  このコースでは: ソースを変えたことにする
sleep | 指定した秒数だけ待つ
du | フォルダやファイルの大きさを出す
  du -sh は合計を読みやすい単位で、du -sk は KB 単位で
  (-s が合計だけ、-h が読みやすい単位、-k が KB 単位。
   du -h だけなら、中のフォルダごとに出す)
ps | いま動いているプロセスの一覧を表示する
  -e は全部のプロセス、-o は表示する項目の指定
/usr/bin/time | コマンドにかかった時間などを報告する
uname | OS などシステムの情報を表示する
make | ソースからファイルを作る手順を実行する道具
  (Ant の説明で、似たものとして名前が出る)
 
# 比較のために出る、Node と Rust の道具
node | Node.js を起動する
  node -r 名前 は、先に読み込むモジュールの指定
  --print-bytecode は、V8 のデバッグ用の指定
npm | Node のパッケージの道具
  npm install と npm ci は依存を入れる
  npm run は scripts に書いた手順を実行する
nest | NestJS の道具。nest new は雛形を作る
  nest build はビルドする
tsc | TypeScript のコンパイラ
cargo | Rust のビルドの道具
  cargo build --release の形で出る
rustc | Rust のコンパイラ(版の表示に名前が出る)

記号 | 意味
  手元では: コースに出る形
 
$(行頭) | プロンプト。ここからがコマンド。打たない
./ | その場所にあるファイルを実行する
  (/ を含まない名前は、決まった場所の一覧から探す)
  手元では: ./mvnw、./gradlew
| | 左のコマンドの出力を、右のコマンドの入力にする
  手元では: jar tf app.jar | wc -l
&& | 左が成功(終了コード 0)したら、右を実行する
  手元では: ls -l app.jar && jar tf app.jar
; | 左が終わったら、続けて右を実行する
  手元では: sleep 1; touch ...; ant
$( ... ) | かっこの中のコマンドを実行し、その出力を
  その場に埋め込む
  手元では: javac -d out $(find src -name "*.java")
      find が見つけた .java の名前が、
      javac の引数として並ぶ
*(引用符なし) | 名前が合うファイルの一覧に置き換わる
  手元では: ls -l *.jar(.jar で終わるファイル全部)
' ' | 中の文字を、そのまま1語として道具に渡す
" " | 同じ。ただし中の $ などはシェルが読む
  手元では: find src -name "*.java"
      (* をシェルに置き換えさせず、find に渡す)
\ | 次の1文字を、シェルに読ませずそのまま渡す
  手元では: awk "{print \$5, \$9}"
~ | 自分のホームフォルダ
  手元では: ~/.m2/repository
$HOME | ホームフォルダの場所が入った変数(~ と同じ場所)
  手元では: $HOME/.m2/repository/...
$? | 直前のコマンドの終了コード
  手元では: echo "mvn exit $?"
` ` | $( ) の古い書き方。このコースでは、補足の文の中で
  コマンド名を囲む印としてだけ出る
  手元では: (after the first, cold `mvn package` ...)
 
# シェルではなく java が読む *
-cp "lib/*" | lib の中の .jar 全部、という
  java のクラスパスの書き方(java のマニュアル)
  引用符で囲んであるので、シェルは * を置き換えず、
  そのまま java に渡る
  手元では: java -cp "app.jar:lib/*" com.example.app.Main
      java -cp 'out:lib/*' demo.XmlMain
 
# 実物: 終了コードが見える2つの例
$ mvn -B -o -ntp -q package; echo "mvn exit $?"
mvn exit 0
 
$ java Nope
Error: Could not find or load main class Nope
Caused by: java.lang.ClassNotFoundException: Nope
[exit 1]

# 書式(java のマニュアル)
#   java [オプション] クラス名 [引数 ...]
#   java [オプション] -jar JARファイル [引数 ...]
 
$ java -cp out -Dwho=Java app.Main
  java への指示: -cp out、-Dwho=Java
  アプリへの引数: 無し
 
$ java -jar demo.jar --server.port=8084
  java への指示: -jar demo.jar
  アプリへの引数: --server.port=8084
      (Spring Boot が設定値 server.port として読む)
 
$ java -Dserver.port=8085 -jar demo.jar
  java への指示: -Dserver.port=8085、-jar demo.jar
      (-D はシステムプロパティ。java が受け取る)
  アプリへの引数: 無し
 
$ java ... l17.plain.PlainApp --debug
  アプリへの引数: --debug
      (Spring Boot が読む。java の指示ではない)
 
$ java -Djarmode=tools -jar demo.jar list-layers
  java への指示: -Djarmode=tools、-jar demo.jar
  アプリへの引数: list-layers
      (JAR に付いている道具に、層の一覧を頼む)
 
$ java -Xshare:off -Xlog:class+load -cp out com.example.demo.Hello
  java への指示: -Xshare:off、-Xlog:class+load、-cp out
  アプリへの引数: 無し
 
# コースに出る、アプリへの引数(どれも Spring Boot が読む)
#   --server.port=8084
#   --debug
#   --spring.threads.virtual.enabled=true
#   --spring.jpa.show-sql=true
#   --spring.jpa.open-in-view=false
#   --spring.aop.proxy-target-class=false
#   --logging.level.org.springframework.boot=DEBUG
#   --app.greeting=...、--app.max-retry-count=2

オプション(道具) | 意味
  例: コースに出る形
 
-v(mvn、./mvnw) | 版を表示する(長い形は --version)
  例: ./mvnw -v
-v(ant) | 詳しく表示する(長い形は -verbose)
  例: ant -v
-v(javap) | そのクラスの詳しい情報を表示する
  例: javap -v Hello.class
-v(unzip) | 詳しい形式で一覧する
  (zip を指定しないと、unzip 自身の版の情報を出す)
  例: unzip -v の後ろに JAR のファイル名
-v(grep) | 指定した文字を含まない行を出す
  例: jar tf ... | grep -v BOOT-INF/lib/.
 
-p(javap) | private なものも含めて全部表示する
  例: javap -p -cp out lib.util.Greeter
-p(ant) | 手順(target)の一覧を表示して終わる
  例: ant -p
-p(unzip) | 取り出した中身を、画面(標準出力)に出す
  例: unzip -p app.jar META-INF/MANIFEST.MF
-p(java) | モジュールを探す場所(--module-path)
  例: java -p ... --add-modules spring.core,org.slf4j ...
-p(mkdir) | 途中のフォルダも作る
  例: mkdir -p flat
 
-l(unzip) | 中のファイルを一覧する
  例: unzip -l の後ろに JAR のファイル名
-l(ls) | 大きさなども付けて一覧する
  例: ls -l app.jar
-l(wc) | 行数を数える
  例: find out -type f | wc -l
 
-c(javap) | メソッドごとの命令列を表示する
  例: javap -c -cp out app.Main
-c(grep) | 合った行の数を出す
  例: jar tf ... | grep -c BOOT-INF/lib/.*jar
-C(jar) | 指定したフォルダに移ってから、ファイルを入れる
  例: jar --create --file app.jar -C out .
 
-d(javac) | .class の出力先のフォルダ
  例: javac -d out src/app/Main.java
-D(java) | システムプロパティ(名前と値の組)を設定する
  例: java -cp out -Dwho=Java app.Main
-D(mvn) | Maven に設定値(プロパティ)を渡す
  例: mvn install -DskipTests(Maven 公式の例)
 
-i(curl) | 応答のヘッダも表示する
  例: curl -i http://localhost:8080/hello
-o(mvn) | オフラインで動かす
-o(ps) | 表示する項目を指定する
  例: ps -eo pid,rss,etime,args
 
-cp(java、javac、javap) | クラスを探す場所(3つとも同じ)
  例: java -cp out app.Main