JavaでExcelを操作するためのApache POIとは？POIのダウンロードと解凍・環境変数CLASSPATHへの登録

Java入門

公開日時: 2021-08-23 　更新日時: 2021-10-08

JavaでExcelを操作するためのApache POIとは？POIのダウンロードと解凍・環境変数CLASSPATHへの登録

この記事でわかること

システム エンジニア: JavaでExcelを操作するためのApache POIとはどのようなものなのでしょうか。

プロジェクト マネージャー: JavaでExcelを操作するために使用する、一般的なオープンソースです。

JavaでExcelを操作するためのApache POIとは？

JavaでExcelを操作するには、よく知られ一般的なのはオープンソースのApache POIを導入することです。POIは例えばWindowsではjarファイルの集まりで、つまり、Javaのライブラリ群です。

それを環境変数にCLASSPATHとしてPOIのjarファイルを設定してPOIが使えるようになります。

POIのダウンロードと解凍

それではPOIをダウンロードして適当なところでダウンロードしたzipファィルを解凍します。下記サイトよりPOIの最新バージョンをダウンロードします。
Apache POI

2021年6月13日現在POIは5.0.0が最新版です。POIをダウンロードしたならばzipファイルを解凍すればPOIのインストールは終了です。

環境変数CLASSPATHへの登録

POIのどのjarファイルが使用されるのか分からなかったので、POIのjarファイル全てを環境変数CLASSPATHに登録しました。

最低これだけを登録すればいいということがあるとは思うのですが、ネットではPOIの4.x.xバージョンの情報しか見つからなかったので、面倒ですが、全てをCLASSPATHに登録しました。

そうでないとコンパイル時にエラーとなります。

CLASSPATHの登録の仕方

それでは環境変数CLASSPATHにPOIのjarファイルを実際に登録しましょう。

Windows 10がここでの開発環境です。当然、JDKが事前にインストールされているということはいうまでもありません。

「スタートボタン」を右クリックして「システム」を選ぶと「詳細情報」の画面が立ち上がります。その右側に「システムの詳細設定」という項目がありますので、それをクリックします。

「システムのプロパティ」が立ち上がりますので、下部の「環境変数」をクリックします。「ユーザの環境変数」と「システムの環境変数」を見て、CLASSPATHの項目があれば、そこにPOIのjarファイルを登録してゆけばよいのです。

なければ、例えば「システムの環境変数」の「新規」をクリックして「変数名」に「CLASSPATH」と入力します。そして、「変数値」にPOIのjarファイルの絶対パスを登録していきます。

まず、一つを登録し、「OK」を押してから「編集」で登録して行くのがよいでしょう。

PS D:\Dropbox\poi-bin-5.0.0-20210120> Get-ChildItem   -Recurse                                                          
    Directory: D:\Dropbox\poi-bin-5.0.0-20210120

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
da---          2021/01/13     0:48                poi-5.0.0

    Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
da---          2021/01/13     0:48                auxiliary
da---          2021/01/13     0:48                docs
da---          2021/01/13     0:48                lib
da---          2021/01/13     0:48                ooxml-lib
-a---          2021/01/12    23:41          17915 LICENSE
-a---          2021/01/12    23:41           1104 NOTICE
-a---          2021/01/13     0:25        2906684 poi-5.0.0.jar
-a---          2021/01/13     0:27         376671 poi-examples-5.0.0.jar
-a---          2021/01/13     0:27          28985 poi-excelant-5.0.0.jar
-a---          2021/01/13     0:33          65674 poi-integration-5.0.0.jar
-a---          2021/01/13     0:27        1880314 poi-ooxml-5.0.0.jar
-a---          2021/01/13     0:26       19267559 poi-ooxml-full-5.0.0.jar
-a---          2021/01/13     0:33        8137483 poi-ooxml-lite-5.0.0.jar
-a---          2021/01/13     0:26        1860106 poi-scratchpad-5.0.0.jar

    Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\auxiliary

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          2021/01/12    23:43        4292177 batik-all-1.13.jar
-a---          2021/01/12    23:43         887800 bcpkix-jdk15on-1.68.jar
-a---          2021/01/12    23:43        5961178 bcprov-jdk15on-1.68.jar
-a---          2021/01/12    23:43        1563053 fontbox-2.0.22.jar
-a---          2021/01/12    23:43          72090 graphics2d-0.30.jar
-a---          2021/01/12    23:43        2735422 pdfbox-2.0.22.jar
-a---          2021/01/12    23:43          85686 xml-apis-ext-1.3.04.jar
-a---          2021/01/12    23:43         674446 xmlgraphics-commons-2.4.jar
-a---          2021/01/12    23:43        1122253 xmlsec-2.2.1.jar
（省略）
   Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\lib

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          2021/01/12    23:43         353793 commons-codec-1.15.jar
-a---          2021/01/12    23:43         751914 commons-collections4-4.4.jar
-a---          2021/01/12    23:43        2213560 commons-math3-3.6.1.jar
-a---          2021/01/12    23:43          24510 SparseBitSet-1.2.jar

    Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\ooxml-lib

Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
-a---          2021/01/12    23:43         632424 commons-compress-1.20.jar
-a---          2021/01/12    23:43         111875 curvesapi-1.06.jar
-a---          2021/01/12    23:43        2493024 xmlbeans-4.0.0.jar

PS D:\Dropbox\poi-bin-5.0.0-20210120> Get-ChildItem -Recurse

Directory: D:\Dropbox\poi-bin-5.0.0-20210120

Mode LastWriteTime Length Name

---- ------------- ------ ----

da--- 2021/01/13 0:48 poi-5.0.0

Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0

Mode LastWriteTime Length Name

---- ------------- ------ ----

da--- 2021/01/13 0:48 auxiliary

da--- 2021/01/13 0:48 docs

da--- 2021/01/13 0:48 lib

da--- 2021/01/13 0:48 ooxml-lib

-a--- 2021/01/12 23:41 17915 LICENSE

-a--- 2021/01/12 23:41 1104 NOTICE

-a--- 2021/01/13 0:25 2906684 poi-5.0.0.jar

-a--- 2021/01/13 0:27 376671 poi-examples-5.0.0.jar

-a--- 2021/01/13 0:27 28985 poi-excelant-5.0.0.jar

-a--- 2021/01/13 0:33 65674 poi-integration-5.0.0.jar

-a--- 2021/01/13 0:27 1880314 poi-ooxml-5.0.0.jar

-a--- 2021/01/13 0:26 19267559 poi-ooxml-full-5.0.0.jar

-a--- 2021/01/13 0:33 8137483 poi-ooxml-lite-5.0.0.jar

-a--- 2021/01/13 0:26 1860106 poi-scratchpad-5.0.0.jar

Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\auxiliary

Mode LastWriteTime Length Name

---- ------------- ------ ----

-a--- 2021/01/12 23:43 4292177 batik-all-1.13.jar

-a--- 2021/01/12 23:43 887800 bcpkix-jdk15on-1.68.jar

-a--- 2021/01/12 23:43 5961178 bcprov-jdk15on-1.68.jar

-a--- 2021/01/12 23:43 1563053 fontbox-2.0.22.jar

-a--- 2021/01/12 23:43 72090 graphics2d-0.30.jar

-a--- 2021/01/12 23:43 2735422 pdfbox-2.0.22.jar

-a--- 2021/01/12 23:43 85686 xml-apis-ext-1.3.04.jar

-a--- 2021/01/12 23:43 674446 xmlgraphics-commons-2.4.jar

-a--- 2021/01/12 23:43 1122253 xmlsec-2.2.1.jar

（省略）

Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\lib

Mode LastWriteTime Length Name

---- ------------- ------ ----

-a--- 2021/01/12 23:43 353793 commons-codec-1.15.jar

-a--- 2021/01/12 23:43 751914 commons-collections4-4.4.jar

-a--- 2021/01/12 23:43 2213560 commons-math3-3.6.1.jar

-a--- 2021/01/12 23:43 24510 SparseBitSet-1.2.jar

Directory: D:\Dropbox\poi-bin-5.0.0-20210120\poi-5.0.0\ooxml-lib

Mode LastWriteTime Length Name

---- ------------- ------ ----

-a--- 2021/01/12 23:43 632424 commons-compress-1.20.jar

-a--- 2021/01/12 23:43 111875 curvesapi-1.06.jar

-a--- 2021/01/12 23:43 2493024 xmlbeans-4.0.0.jar

以上のjarファイルを全てCLASSPATHに登録しました。

JavaでExcelを操作

POIの設定ができましたので、実際にプログラムを組んでJavaでExcelを操作してみましょう。前提条件として作業フォルダに空のtemplate.xlsxが用意されているものとします。

import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStream;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Path;
import java.nio.file.Paths;

import org.apache.poi.ss.usermodel.Cell;
import org.apache.poi.ss.usermodel.CellStyle;
import org.apache.poi.ss.usermodel.FillPatternType;
import org.apache.poi.ss.usermodel.CellValue;
import org.apache.poi.ss.usermodel.Workbook;
import org.apache.poi.ss.usermodel.Sheet;
import org.apache.poi.ss.usermodel.Row;
import org.apache.poi.xssf.usermodel.XSSFWorkbook;
import org.apache.poi.ss.usermodel.IndexedColors;

public class PoiColor {

    public static void main(String[] args){
        System.out.print("start: main\r\n");

        Workbook tempbook = null;
        try {
            //--- テンプレートファイルをひらいて、シートを指定 --//
            Path tempPath = Paths.get("./template.xlsx");
            InputStream inSt = Files.newInputStream(tempPath);
            tempbook = new XSSFWorkbook(inSt);
            Sheet sheet = tempbook.getSheet("Sheet1");

            //--- Ａ１セルへの書き込み --//
            //--- セル背景色は栗色 --//
            Row row = sheet.createRow(0);
            Cell cell = row.createCell(0);
            cell.setCellValue("あああ");
            CellStyle styleA1 = tempbook.createCellStyle();
            styleA1.setFillPattern(
                FillPatternType.SOLID_FOREGROUND);
            styleA1.setFillForegroundColor(
                IndexedColors.MAROON.getIndex());
            cell.setCellStyle(styleA1);

            //--- Ａ２セルへの書き込み --//
            //--- セル背景色は青 --//
            row = sheet.createRow(1);
            cell = row.createCell(0);
            cell.setCellValue("いいい");
            CellStyle styleA2 = tempbook.createCellStyle();
            styleA2.setFillPattern(
                FillPatternType.SOLID_FOREGROUND);
            styleA2.setFillForegroundColor(
                IndexedColors.BLUE.getIndex());
            cell.setCellStyle(styleA2);

            //--- Ａ３セルへの書き込み --//
            //--- セル背景色は緑 --//
            row = sheet.createRow(2);
            cell = row.createCell(0);
            cell.setCellValue("ううう");
            CellStyle styleA3 = tempbook.createCellStyle();
            styleA3.setFillPattern(
                FillPatternType.SOLID_FOREGROUND);
            styleA3.setFillForegroundColor(
                IndexedColors.GREEN.getIndex());
            cell.setCellStyle(styleA3);

            //--- out.xlsxとしてファイル出力 --//
            Path outPath = Paths.get("./out.xlsx");
            OutputStream outSt = Files.newOutputStream(outPath);
            tempbook.write(outSt);
        } catch (IOException e) {
            System.out.print("入出力例外が発生！");
        } finally {
            //--- テンプレートをクローズ --//
            try {
                if (tempbook != null) {
                    tempbook.close();
                }
            } catch (IOException e) {
                System.out.print("終了処理で入出力例外が発生！");
            }
        }
        System.out.print("end: main\r\n");
    }
}

import java.io.IOException;

import java.io.InputStream;

import java.io.OutputStream;

import java.io.File;

import java.nio.file.Files;

import java.nio.file.Path;

import java.nio.file.Paths;

import org.apache.poi.ss.usermodel.Cell;

import org.apache.poi.ss.usermodel.CellStyle;

import org.apache.poi.ss.usermodel.FillPatternType;

import org.apache.poi.ss.usermodel.CellValue;

import org.apache.poi.ss.usermodel.Workbook;

import org.apache.poi.ss.usermodel.Sheet;

import org.apache.poi.ss.usermodel.Row;

import org.apache.poi.xssf.usermodel.XSSFWorkbook;

import org.apache.poi.ss.usermodel.IndexedColors;

public class PoiColor {

public static void main(String[] args){

System.out.print("start: main\r\n");

Workbook tempbook = null;

try {

//--- テンプレートファイルをひらいて、シートを指定 --//

Path tempPath = Paths.get("./template.xlsx");

InputStream inSt = Files.newInputStream(tempPath);

tempbook = new XSSFWorkbook(inSt);

Sheet sheet = tempbook.getSheet("Sheet1");

//--- Ａ１セルへの書き込み --//

//--- セル背景色は栗色 --//

Row row = sheet.createRow(0);

Cell cell = row.createCell(0);

cell.setCellValue("あああ");

CellStyle styleA1 = tempbook.createCellStyle();

styleA1.setFillPattern(

FillPatternType.SOLID_FOREGROUND);

styleA1.setFillForegroundColor(

IndexedColors.MAROON.getIndex());

cell.setCellStyle(styleA1);

//--- Ａ２セルへの書き込み --//

//--- セル背景色は青 --//

row = sheet.createRow(1);

cell = row.createCell(0);

cell.setCellValue("いいい");

CellStyle styleA2 = tempbook.createCellStyle();

styleA2.setFillPattern(

FillPatternType.SOLID_FOREGROUND);

styleA2.setFillForegroundColor(

IndexedColors.BLUE.getIndex());

cell.setCellStyle(styleA2);

//--- Ａ３セルへの書き込み --//

//--- セル背景色は緑 --//

row = sheet.createRow(2);

cell = row.createCell(0);

cell.setCellValue("ううう");

CellStyle styleA3 = tempbook.createCellStyle();

styleA3.setFillPattern(

FillPatternType.SOLID_FOREGROUND);

styleA3.setFillForegroundColor(

IndexedColors.GREEN.getIndex());

cell.setCellStyle(styleA3);

//--- out.xlsxとしてファイル出力 --//

Path outPath = Paths.get("./out.xlsx");

OutputStream outSt = Files.newOutputStream(outPath);

tempbook.write(outSt);

} catch (IOException e) {

System.out.print("入出力例外が発生！");

} finally {

//--- テンプレートをクローズ --//

try {

if (tempbook != null) {

tempbook.close();

}

} catch (IOException e) {

System.out.print("終了処理で入出力例外が発生！");

}

System.out.print("end: main\r\n");

}

これをPowerShellを立ち上げて

PS （作業フォルダ）>javac -encoding utf-8 .\PoiColore.java

1	PS （作業フォルダ）>javac -encoding utf-8 .\PoiColore.java

として入力してコンパイルします。そして、コンパイルが通ったならば

PS （作業フォルダ）>java PoiColor
start: main
end: main

PS （作業フォルダ）>java PoiColor

start: main

end: main

と入力します。すると、作業フォルダにout.xlsxファイルが生成されていて、それを開くとプログラムで狙ったExcelの操作ができています。

ソースコードの解説

それではJavaでExcelをPOIのライブラリを利用して操作したソースコードの解説をします。

まず、セルの指定と文字列の書き込みですが、それはJavaのソースコードの次の箇所に当たります。

//--- Ａ１セルへの書き込み --//
//--- セル背景色は栗色 --//
Row row = sheet.createRow(0);
Cell cell = row.createCell(0);
cell.setCellValue("あああ");

//--- Ａ１セルへの書き込み --//

//--- セル背景色は栗色 --//

Row row = sheet.createRow(0);

Cell cell = row.createCell(0);

cell.setCellValue("あああ");

POIは0オリジンでrow（行）とcolum（列）を指定する形でJavaでExcelの操作を行います。Excelでは行は1から始まり列はアルファベットのAで始まりますが、JavaのPOIでは先述のように0オリジンです。そこを間違いないように気を付けてください。

色の指定

POIの色の指定ですが、塗りつぶし方は列挙型で指定されていて、色も何色もあるわけではなく、指定されています。
例えば

CellStyle styleA1 = tempbook.createCellStyle();
styleA1.setFillPattern(FillPatternType.SOLID_FOREGROUND);
styleA1.setFillForegroundColor(IndexedColors.MAROON.getIndex());
cell.setCellStyle(styleA1);

CellStyle styleA1 = tempbook.createCellStyle();

styleA1.setFillPattern(FillPatternType.SOLID_FOREGROUND);

styleA1.setFillForegroundColor(IndexedColors.MAROON.getIndex());

cell.setCellStyle(styleA1);

この箇所を例に取ると、setFillPatternメソッドで色の塗りつぶし方を指定しているのですが、ここでは所謂べた塗りを指定しています。setFillForegroundColorメソッドで色を指定しています。ここでは栗色が指定されています。

このようにJavaでExcelを操作するには最初はとっつきにくいかもしれませんが、パターンが決まっていますので、サンプルソースコードはそれほど難しいことをしてはいないのです。

システム エンジニア: JavaをインストールするだけではJavaでExcelを操作することができないのですね。

プロジェクト マネージャー: この機会にApache POIを導入し、JavaでExcelを自在に操作してみましょう。

JavaでExcelを操作するにはApache POIがお勧め

いかがでしたでしょうか。JavaでExcelを操作するにはJavaをインストールしただけではExcelは扱えず、Apache POIというライブラリの導入が一般的です。

POIが導入できたならば、JavaでもExcelが自在に操作できますので、色々なサイトを参考にして実際に自身でソースコードを書いてExcelを操作してみてください。

FEnetJava・Javaコラムは株式会社オープンアップシステムが運営しています。

株式会社オープンアップシステムはこんな会社です

秋葉原オフィスには株式会社オープンアップシステムをはじめグループのIT企業が集結！
数多くのエンジニアが集まります。

スマホアプリから業務系システムまで

スマホアプリから業務系システムまで開発案件多数。システムエンジニア・プログラマーとしての多彩なキャリアパスがあります。
充実した研修制度

毎年、IT技術のトレンドや社員の要望に合わせて、カリキュラムを刷新し展開しています。社内講師の丁寧なサポートを受けながら、自分のペースで学ぶことができます。
資格取得を応援

スキルアップしたい社員を応援するために資格取得一時金制度を設けています。受験料(実費)と合わせて資格レベルに合わせた最大10万円の一時金も支給しています。
東証プライム上場企業グループ

オープンアップシステムは東証プライム上場「株式会社オープンアップグループ」のグループ企業です。

安定した経営基盤とグループ間のスムーズな連携でコロナ禍でも安定した雇用を実現させています。

株式会社オープンアップシステムに興味を持った方へ

株式会社オープンアップシステムでは、開発系エンジニア・プログラマを募集しています。

年収をアップしたい！スキルアップしたい！大手の上流案件にチャレンジしたい！
まずは話だけでも聞いてみたい場合もOK。お気軽にご登録ください。

株式会社オープンアップシステムへ応募する
会員登録不要! カンタン45秒!

JavaでExcelを操作するためのApache POIとは？POIのダウンロードと解凍・環境変数CLASSPATHへの登録

JavaでExcelを操作するためのApache POIとは？

POIのダウンロードと解凍

環境変数CLASSPATHへの登録

CLASSPATHの登録の仕方

JavaでExcelを操作

ソースコードの解説

色の指定

JavaでExcelを操作するにはApache POIがお勧め

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

Java新着案件New Job

官公庁向け業務システム開発/Java/東京都千代田区/【WEB面談可】/テレワーク

販売管理システム開発/Java/東京都中央区/【WEB面談可】/テレワーク

生命保険会社向けシステム開発/Java/東京都千代田区/【WEB面談可】/テレワーク

社会保険システムのパッケージ開発/Java/東京都港区/【WEB面談可】/テレワーク

金融機関向けシステム更改/Java/東京都江東区/【WEB面談可】/テレワーク

大手通信会社者向けWebシステム改修/Java/東京都港区/【WEB面談可】/テレワーク

JavaでExcelを操作するためのApache POIとは？POIのダウンロードと解凍・環境変数CLASSPATHへの登録

JavaでExcelを操作するためのApache POIとは？

POIのダウンロードと解凍

環境変数CLASSPATHへの登録

CLASSPATHの登録の仕方

JavaでExcelを操作

ソースコードの解説

色の指定

JavaでExcelを操作するにはApache POIがお勧め

株式会社オープンアップシステムはこんな会社です

スマホアプリから業務系システムまで

充実した研修制度

資格取得を応援

東証プライム上場企業グループ

株式会社オープンアップシステムに興味を持った方へ

Java新着案件New Job

官公庁向け業務システム開発/Java/東京都千代田区/【WEB面談可】/テレワーク

販売管理システム開発/Java/東京都中央区/【WEB面談可】/テレワーク

生命保険会社向けシステム開発/Java/東京都千代田区/【WEB面談可】/テレワーク

社会保険システムのパッケージ開発/Java/東京都港区/【WEB面談可】/テレワーク

金融機関向けシステム更改/Java/東京都江東区/【WEB面談可】/テレワーク

大手通信会社者向けWebシステム改修/Java/東京都港区/【WEB面談可】/テレワーク

関連記事Related Posts