Ruby on Rails チュートリアル2章
概要
Ruby の Web Framework である Ruby on Rails のチュートリアルについてまとめる。
対象読者としては、チュートリアルを一度は読んだけどチュートリアルからいちいちコマンドなどを再確認するのが面倒な場合など。
使用環境
※ 全部基本的に無料
IDE (Integrated Development Environment)
Cloud 9 (Cloud9 - Your development environment, in the cloud)
Heroku
事前準備 (前回記事とほぼ同じ)
今回は、前回のアプリは扱わないため、新しくプロジェクトを作成する。
なお、今回は チュートリアルに習い、プロジェクト名を toy_app として記述する。
プロジェクト作成
$ cd ~/workspace $ rails _4.2.2_ new toy_app $ cd toy_app/
Gemfile 置換
$ rm ~/workspace/toy_app/Gemfile $ vi ~/workspace/toy_app/Gemfile
以下をコピペで貼付けて作成。
source 'https://rubygems.org' gem 'rails', '4.2.2' gem 'sass-rails', '5.0.2' gem 'uglifier', '2.5.3' gem 'coffee-rails', '4.1.0' gem 'jquery-rails', '4.0.3' gem 'turbolinks', '2.3.0' gem 'jbuilder', '2.2.3' gem 'sdoc', '0.4.0', group: :doc group :development, :test do gem 'sqlite3', '1.3.9' gem 'byebug', '3.4.0' gem 'web-console', '2.0.0.beta3' gem 'spring', '1.1.3' end group :production do gem 'pg', '0.17.1' gem 'rails_12factor', '0.0.2' end
本番環境用のgemを除いたローカルgemをインストール
$ bundle install --without production
Gitの管理下におく
$ git init $ git add -A $ git commit -m "Initialize repository"
Bitbucket 登録
リボジトリ作成 (bitbucket のサイトで作成)
次に以下のコマンドで作成
$ git remote add origin git@bitbucket.org:${USER_NAME}>/toy_app.git $ git push -u origin --all
Applicationコントローラにhelloを追加
デフォルトページを変更する
2章内容(名前変更必要)
作成するデータ定義
ユーザ情報 (users)
- id :integer
- name :string
- email :string
マイクロポスト (microposts)
- id :integer
- content :text
- user_id :integer
Userリソース作成
Railsのscaffoldを用いて作成する。
$ rails generate scaffold User name:string email:string
Rakeを使用してデータベースをマイグレート(データベース更新・usersデータモデル作成)
※ rake db:migrate でもいける場合もあるがシステム依存らしい
$ bundle exec rake db:migrate
サーバ起動して追加リソースを見る
サーバ起動
ローカル
$ rails server # ローカル環境 $ rails server -b $IP -p $PORT # Cloud 9
リソース先にアクセス
下記のRestful APIが自動生成される。
アクセス可能なページ(URL)一覧
メソッド | URL | アクション | 用途 |
---|---|---|---|
GET | /users | index | すべてのユーザーを表示するページ |
GET | /users/1 | show | id=1のユーザーを表示するページ |
GET | /users/new | new | ユーザーを新規作成するページ |
GET | /users/1/edit | edit | id=1のユーザーを編集するページ |
メソッド | URL | アクション | 用途 |
---|---|---|---|
POST | /users | create | ユーザーを作成するアクション |
PATCH | /users/1 | update | id=1のユーザーを更新するアクション |
DELETE | /users/1 | destroy | id=1のユーザーを削除するアクション |
(筆者追記) 動作実行前との差分を知りたければ $ git status を実行する。
リソースの自動生成について
挙動説明
プログラムとDBがどのように連携しているかの説明。本記事は手順書的な意味合いが強いので割愛。
挙動確認・変更方法
上記リソースのアクセス先ルーティングを変更したい場合、routers.rbを変更する。
vi config/routes.rb
Rails.application.routes.draw do resources :users # The priority is based upon order of creation: first created -> highest priority. # See how all your routes lay out with "rake routes". # You can have the root of your site routed with "root" root 'users#index' # 'application#hello から変更 (以下省略)
もし、さきほどの Restful API の各挙動を知りたければ、app/controllers/users_controller.rb を参照する。
$ less app/controllers/users_controller.rb
自動生成したリソースの欠点
- データ検証がされていない
- 誰でも作成・参照・更新・削除可能
- 業務要件を満たすテストが存在しない
- レイアウトやスタイルはデフォルト
- 理解が困難
micropostsリソース作成
microposts リソース作成
基本的にUserリソースと同じ。
$ rails generate scaffold Micropost content:text user_id:integer $ bundle exec rake db:migrate
動作確認
挙動変更
マイクロポストの文字数に制限をかける。
vi app/models/micropost.rb
class Micropost < ActiveRecord::Base validates :content, length: { maximum: 140 } # 追加 end
データモデル同士の関連付け
※ユーザとユーザ ID が一致した microposts を事前に作成しておくこと。
user.rb を編集する
$ vi app/models/user.rb
class User < ActiveRecord::Base has_many :microposts # 追加 end
micropost.rb を編集する
vi app/models/micropost.rb
class Micropost < ActiveRecord::Base belongs_to :user # 追加 validates :content, length: { maximum: 140 } # 追加 end
関連付け確認方法
rails console を使用して確認する。
$ rails console >> first_user = User.first >> first_user.microposts
コンソール実行例 (この例では、ユーザが二人いて二人目がデータ持っていた)
2.3.0 :003 > second_user = User.second User Load (0.4ms) SELECT "users".* FROM "users" ORDER BY "users"."id" ASC LIMIT 1 OFFSET 1 => #<User id: 8, name: "XYZ", email: "xyz@aaa.com", created_at: "2016-07-02 07:37:50", updated_at: "2016-07-02 07:37:50"> 2.3.0 :004 > second_user.microposts Micropost Load (0.3ms) SELECT "microposts".* FROM "microposts" WHERE "microposts"."user_id" = ? [["user_id", 8]] => #<ActiveRecord::Associations::CollectionProxy [#<Micropost id: 2, content: "あああああ", user_id: 8, created_at: "2016-07-02 07:44:23", updated_at: "2016-07-02 07:44:23">, #<Micropost id: 3, content: "AAAAAAAAAAAA", user_id: 8, created_at: "2016-07-02 07:44:56", updated_at: "2016-07-02 07:44:56">]>
Ctrl + D で終了する。
※ なお、user.rb で設定していないと例外が発生する。
2.3.0 :002 > second_user.microposts NoMethodError: undefined method `microposts' for #<User:0x007faa00082788> from /usr/local/rvm/gems/ruby-2.3.0/gems/activemodel-4.2.2/lib/active_model/attribute_methods.rb:433:in `method_missing' from (irb):2 from /usr/local/rvm/gems/ruby-2.3.0/gems/railties-4.2.2/lib/rails/commands/console.rb:110:in `start' from /usr/local/rvm/gems/ruby-2.3.0/gems/railties-4.2.2/lib/rails/commands/console.rb:9:in `start' from /usr/local/rvm/gems/ruby-2.3.0/gems/railties-4.2.2/lib/rails/commands/commands_tasks.rb:68:in `console' from /usr/local/rvm/gems/ruby-2.3.0/gems/railties-4.2.2/lib/rails/commands/commands_tasks.rb:39:in `run_command!' from /usr/local/rvm/gems/ruby-2.3.0/gems/railties-4.2.2/lib/rails/commands.rb:17:in `<top (required)>' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:274:in `require' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:274:in `block in require' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:240:in `load_dependency' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:274:in `require' from /home/ubuntu/workspace/toy_app/bin/rails:9:in `<top (required)>' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:268:in `load' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:268:in `block in load' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:240:in `load_dependency' from /usr/local/rvm/gems/ruby-2.3.0/gems/activesupport-4.2.2/lib/active_support/dependencies.rb:268:in `load' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/commands/rails.rb:6:in `call' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/command_wrapper.rb:38:in `call' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:180:in `block in serve' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:153:in `fork' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:153:in `serve' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:128:in `block in run' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:122:in `loop' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application.rb:122:in `run' from /usr/local/rvm/gems/ruby-2.3.0/gems/spring-1.1.3/lib/spring/application/boot.rb:18:in `<top (required)>' from /usr/local/rvm/rubies/ruby-2.3.0/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require' from /usr/local/rvm/rubies/ruby-2.3.0/lib/ruby/2.3.0/rubygems/core_ext/kernel_require.rb:55:in `require' from -e:1:in `<main>'2.3.0 :003 >
継承階層
作成したモデル(Users, Microposts) は ActionController::Base を継承する。
このため、作成したモデルはデータベースにアクセスしカラムをあたかもRubyの属性のように扱える。
また、作成したモデルコントローラ(UsersController, MicropostController) は ApplicationController を継承する。
このため、ApplicationControllerで定義したルールはすべてのコントローラに反映される。
デプロイ
ローカルに変更をコミットし、bitbucket に push する
$ git status $ git add -A $ git commit -m "Finish toy app" $ git push
herokuにデプロイ。
$ git push heroku # デプロイ $ heroku run rake db:migrate # マイグレーション
Ruby on Rails チュートリアル1章
概要
Ruby の Web Framework である Ruby on Rails のチュートリアルについてまとめる。
対象読者としては、チュートリアルを一度は読んだけどチュートリアルからいちいちコマンドなどを再確認するのが面倒な場合など。
使用環境
※ 全部基本的に無料
IDE (Integrated Development Environment)
Cloud 9 (Cloud9 - Your development environment, in the cloud)
Heroku
1章内容
Ruby on Rails の知識・チュートリアルの基本的な取り決めなど
Rails こんなすごい
- オープンソース
- 最新の技術動向に敏感
- 熱心なコミュニティ
チュートリアル実施の前提知識
- 基本的に前提知識はなくても大丈夫。もちろん知っているに越した事はない。
- 個人的には、プログラミングを過去に書いた事ある人ならできる内容
足りない所は適宜補完する(Ruby, HTML, CSS, JavaScript, SQLなど) - 記法の説明、流し読みすれば OK
- コンソール上のコマンドの書き方
- パスの記述
- プログラムの書き方。省略記号をそのままソースコードに記述しないこと!
とりあえず動かしてみる
上記使用環境の利用方法説明がひたすら続く
※ 当然だけど、各サービスのWeb画面もいつかは変化するので適宜読み替える
※ 事前にローカル環境もしくは Cloud 9 のどちらで開発するか決めること。個人的に Cloud 9 の方が環境依存なくて良いと思う。
- Ruby の導入 (※Cloud9 は不要)
※ Windows では ruby がデフォルトで入ってないので導入する。
※ Mac OS はデフォルトで入ってるけど、バージョン古いかも。(私の環境では Ruby 2.0.0)
Ruby のインストール確認方法$ ruby -v ruby 2.0.0p481 (2014-05-08 revision 45883) [universal.x86_64-darwin13]
- Rails をインストール
$ gem install rails -v 4.2.2
- プロジェクト用フォルダ作成、そこにプロジェクト作成
$ APP_NAME=アプリ名をココにいれて! $ mkdir ~/workspace $ cd ~/workspace $ rails _4.2.2_ new ${APP_NAME}
- Gemfile の置換
$ rm ~/workspace/${APP_NAME}/Gemfile $ vi ~/workspace/${APP_NAME}/Gemfile
以下をコピペで貼付けて作成。
source 'https://rubygems.org' gem 'rails', '4.2.2' gem 'sass-rails', '5.0.2' gem 'uglifier', '2.5.3' gem 'coffee-rails', '4.1.0' gem 'jquery-rails', '4.0.3' gem 'turbolinks', '2.3.0' gem 'jbuilder', '2.2.3' gem 'sdoc', '0.4.0', group: :doc group :development, :test do gem 'sqlite3', '1.3.9' gem 'byebug', '3.4.0' gem 'web-console', '2.0.0.beta3' gem 'spring', '1.1.3' end
- Rails サーバを起動する
サーバ起動はそれ専用の端末になってしまうため、別タブ・別ウィンドウで起動すること。$ APP_NAME=アプリ名をココにいれて! $ cd ~/workspace/${APP_NAME} $ rails server
Cloud 9 の場合
$ APP_NAME=アプリ名をココにいれて! $ cd ~/workspace/${APP_NAME} $ rails server -b $IP -p $PORT
なお、APP_NAME を2回いれるのが面倒な場合は、以下のコマンドを実行する事。
これによって、ターミナル起動時に設定が読み込まれるため、別タブに移動しても同様の操作が可能になる。
Mac OSXの場合echo "APP_NAME=hello_app" >> ~/.bash_profile
Linux環境の場合
echo "APP_NAME=hello_app" >> ~/.bashrc
- 動作確認
ローカル環境なら
http://localhost:3000/ にアクセスし、以下のようなデフォルトページが表示されれば OK。
Cloud 9 であれば、[Share]ボタンをクリックして、環境設定中の[Application]にある URL にアクセスする。
デフォルトページに Hello World 表示
- コントローラにweb表示時の挙動を記述。
$ vi ~/workspace/${APP_NAME}/app/controllers/application_controller.rb
hello という挙動を定義する。(hello, worldって表示するだけ)
class ApplicationController < ActionController::Base # Prevent CSRF attacks by raising an exception. # For APIs, you may want to use :null_session instead. protect_from_forgery with: :exception def hello # hello メソッド追加 (3行) render text: "hello, world!" # hello, world を表示 end end
- 現在のアプリケーションのルーティング情報を設定する。
vi ~/workspace/${APP_NAME}/config/routes.rb
アプリケーションルート(http://localhost:3000/など)に hello の挙動を設定する。
Rails.application.routes.draw do # The priority is based upon order of creation: first created -> highest priority. # See how all your routes lay out with "rake routes". # You can have the root of your site routed with "root" root 'application#hello' # ApplicationController クラスの hello メソッドを呼び出す (以下省略)
再度動作確認。hello, world って書かれてればOK。
開発におけるソースコード管理からデプロイまで
以下は、Ruby on Rails 以外に関わる内容のため、概要のみ。
ソースコードのバージョン管理
初回作業
Git 設定
- Git インストール (※ Cloud 9 では不要)
- Git 設定
バージョン情報で誰が更新したかの情報などに使われる。$ git config --global user.name "Your Name" $ git config --global user.email your.email@example.com $ git config --global push.default matching
- Bitbucket 登録
Bitbucket — The Git solution for professional teams - 公開鍵作成(※ 既に存在する場合・Cloud 9 では不要)
$ ssh-keygen -t rsa Generating public/private rsa key pair. Enter file in which to save the key (/Users/XXXXXX/.ssh/id_rsa): Created directory '/Users/XXXXXX/.ssh'. Enter passphrase (empty for no passphrase): Enter same passphrase again: Your identification has been saved in /Users/XXXXXX/.ssh/id_rsa. Your public key has been saved in /Users/XXXXXX/.ssh/id_rsa.pub. The key fingerprint is: be:e9:16:45:e1:56:d3:e3:01:61:0e:ac:3e:61:42:18 XXXXXX@YYYYY-ZZZZZ.local The key's randomart image is: +--[ RSA 2048]----+ | | | | | . . | | E+ | | o = o S | | + B o. | | o = B . | | o * o . | | o . Bo+ | +-----------------+
公開鍵の内容出力
$ cat ~/.ssh/id_rsa.pub
公開鍵を Bitbucket ->[アカウントの管理]->[SSH キー] に登録
開発作業手順
- トピックブランチ作成 + 現ブランチ確認
$ git checkout -b ${BRANCH_NAME} $ git branch
- ソースコード修正
- 現ブランチの状態確認
以下の例では、変更状態にあることが示されている。$ git status On branch master Your branch is up-to-date with 'origin/master'. Changes not staged for commit: (use "git add <file>..." to update what will be committed) (use "git checkout -- <file>..." to discard changes in working directory) modified: toy_app/app/controllers/application_controller.rb no changes added to commit (use "git add" and/or "git commit -a")
- 変更をステージ/コミット
ステージ - 変更をコミット対象にする(コミットはまだされない)
コミット - 変更をブランチの最新状態にする
特定のファイルをステージ段階にする$ git add ${TARGET_FILES}
全てのファイルをステージ段階にする
$ git add -A
ステージ対象をコミット
$ git commit -m "コミット内容"
全変更対象をステージ段階をすっとばしコミット (ただし新しく追加したファイルは適用されない)
$ git commit -a -m "コミット内容"
- トピックブランチの変更をマスタにマージ
$ git checkout master $ git merge ${BRANCH_NAME}
- トピックブランチ削除
$ git branch -d ${BRANCH_NAME}
- ローカルリポジトリの内容をリモートに反映する
$ git push
デプロイ
ここでは、Heroku を利用したデプロイを記述する。
初回作業
- Gemfile 設定追加
DB に PostgreSQL を利用するため、この内容を Gemfile に記述。$ vi ~/workspace/${APP_NAME}/Gemfile
末尾に4行追加。
source 'https://rubygems.org' gem 'rails', '4.2.2' gem 'sass-rails', '5.0.2' gem 'uglifier', '2.5.3' gem 'coffee-rails', '4.1.0' gem 'jquery-rails', '4.0.3' gem 'turbolinks', '2.3.0' gem 'jbuilder', '2.2.3' gem 'sdoc', '0.4.0', group: :doc group :development, :test do gem 'sqlite3', '1.3.9' gem 'byebug', '3.4.0' gem 'web-console', '2.0.0.beta3' gem 'spring', '1.1.3' end # 下記4行追加 group :production do gem 'pg', '0.17.1' gem 'rails_12factor', '0.0.2' end
ローカル環境で追加した内容(production)を反映しないように bundler に設定
(さらに、この変更をコミット)$ bundle install --without production $ git commit -a -m "Update Gemfile.lock for Heroku"
- Heroku アカウント登録
Heroku - Heroku Toolbelt インストール (Cloud 9 の場合不要)
Heroku Command Line | Heroku Dev Center - Heroku CLI がインストール済か確認
$ heroku version heroku-toolbelt/3.43.3 (x86_64-linux) ruby/2.3.0 heroku-cli/5.2.14-a56a9ae (linux-amd64) go1.6.2 You have no installed plugins.
- Heroku に新しいインスタンスを作成
Heroku ログイン + 認証鍵追加 + インスタンス作成$ heroku login $ heroku keys:add $ heroku create
アプリケーションを Heroku にデプロイする
- デプロイ方法
$ git push heroku master
- デプロイしたアプリケーションの挙動確認
heroku create 時のコマンドからアクセスすべき ホストが分かるので、
これを元にアクセスして確認する。(以下の例では、http://damp-fortress-5769.herokuapp.com/ になる)$ heroku create Creating damp-fortress-5769... done, stack is cedar http://damp-fortress-5769.herokuapp.com/ | git@heroku.com:damp-fortress-5769.git Git remote heroku added
VirtualBox+Vagrant 環境構築(Windows 7+Cygwin) 苦戦記
概要
ソフトウェアについて
VirtualBox?
仮想化環境を提供するソフトウェア。その他、有名なソフトウェアには VMWare がある。
Oracle が提供している。基本的に無料で使える。
Windows?
た・・大変申し訳ありませんが、多分その方にはこの記事の内容はおそらく理解できないです。(^^;
なんのため?
- 本番を想定したテスト環境を作成したり、その上で簡単なテストしたりするため。
- 継続的デリバリー(CD)を実現するため。
(参考:DevOps時代の開発者のための構成管理入門(終):継続的デリバリ/デプロイを実現する手法・ツールまとめ (1/2) - @IT)
環境構築
今回使用環境
Operating System
- Windows 7 Professional Service Pack1(64bit)
Console
- Cygwin (mintty 2.2.2)
- 英語だけど文献いっぱいあるからなんとかなる。(cygwin 導入 - Google 検索)
- 個人的に使いやすいと思ってるから使ってる
Vagrant を使うのに必要なアプリケーション
導入
- VirtualBox (ver5.0.20)
- Vagrant (ver1.8.1)
構築手順
VirtualBox + Vagrant Install
これらの環境セッティングは世の中にいっぱいあるので、それらに任せる。
注意点として、Ruby のパッケージ管理ツール gem からの Vagrant 提供は終了しているらしいので、
インストーラでインストールすること。(参考:Vagrant 1.1.x のインストール - oooooooo)
なお、私はこのサイトを参考にさせてもらった。操作も少なく、かなり簡単。
Windows上でVirtualBox+Vagrant+CentOSによる仮想環境構築 - Qiita
起動失敗
仮想化設定
問題なくインストールは終了したのだが、起動しても仮想マシンが起動しない。
「仮想化支援機能(VT-z/AMD-V)を有効化できません。・・・・」ってアラートが出る。
(同一事象:仮想化支援機構(VT-x/AMD-V)を有効化できません | Futurismo)
調べてみると、マザボの BIOS から CPU の仮想化設定を有効にしないといけないそうだ。
システム設定 | VirtualBox Mania
CPU は Intel core i7-3770K。仕様を調べるとサポートしてた。(Intel® Core™ i7-3770K Processor (8M Cache, up to 3.90 GHz) 仕様)
で。BIOS から探し出して有効化すると起動。
もし、サポートしてない場合は・・諦めるか、CPU 取り替えましょう。
rsync 実行が失敗
インストール後は Cygwin のコマンドで仮想化などの操作を実行できる。
また、仮想化用の OS は box と呼ばれており、以下のサイトで入手できる。
私は、Raspberry Pi の OS が raspbian jessie なので、そのテスト環境 Debian jessie を入れることに。
(実際は少し違うかもしれないけど)
仮想マシン起動コマンド
$ vagrant box add "debian-jessie" https://github.com/holms/vagrant-jessie-box/releases/download/Jessie-v0.1/Debian-jessie-amd64-netboot.box $ vagrant init debian-jessie $ vagrant up
で、エラーがでると。
$ vagrant up Bringing machine 'default' up with 'virtualbox' provider... ==> default: Checking if box 'debian/jessie64' is up to date... ==> default: Clearing any previously set forwarded ports... ==> default: Clearing any previously set network interfaces... ==> default: Preparing network interfaces based on configuration... default: Adapter 1: nat ==> default: Forwarding ports... default: 22 (guest) => 2222 (host) (adapter 1) ==> default: Booting VM... ==> default: Waiting for machine to boot. This may take a few minutes... default: SSH address: 127.0.0.1:2222 default: SSH username: vagrant default: SSH auth method: private key default: Warning: Remote connection disconnect. Retrying... default: Warning: Remote connection disconnect. Retrying... ==> default: Machine booted and ready! GuestAdditions 5.0.20 running --- OK. ==> default: Checking for guest additions in VM... ==> default: Rsyncing folder: /cygdrive/e/cygwin/home/hoshikouki/ => /vagrant There was an error when attempting to rsync a synced folder. Please inspect the error message below for more info. Host path: /cygdrive/e/cygwin/home/hoshikouki/ Guest path: /vagrant Command: rsync --verbose --archive --delete -z --copy-links --chmod=ugo=rwX --no-perms --no-owner --no-group --rsync-path sudo rsync -e ssh -p 2222 -o ControlMaster=auto -o ControlPath=C:/Program Files/cygwin64/tmp/ssh.363 -o ControlPersist=10m -o StrictHostKeyChecking=no -o IdentitiesOnly=true -o UserKnownHostsFile=/dev/null -i 'E:/cygwin/home/hoshikouki/.vagrant/machines/default/virtualbox/private_key' --exclude .vagrant/ /cygdrive/e/cygwin/home/hoshikouki/ vagrant@127.0.0.1:/vagrant Error: ssh: Could not resolve hostname files/cygwin64/tmp/ssh.363: Name or service not known rsync: connection unexpectedly closed (0 bytes received so far) [sender] rsync error: error in rsync protocol data stream (code 12) at io.c(226) [sender=3.1.2]
rsync コマンドが失敗したみたい。
「ControlPath=C:/Program Files/cygwin64/tmp/ssh.363」で半角スペースが混入してるのが問題になっている。
どうやら cygwin 環境で実行すると起こる問題らしく、ソースコードを直接編集して対処。
Windows + vagrant 1.8.1 + rsync 3.1.1 で発生する、config.vm.synced_folderの失敗の直し方 - Qiita
ruby のアプリケーションはインタプリタだから最悪手で調整できるのはありがたい。
もし、壊したら再度インストールすればいいんだし。(^-^;
$ vagrant up Bringing machine 'default' up with 'virtualbox' provider... ==> default: Checking if box 'debian/jessie64' is up to date... ==> default: Clearing any previously set forwarded ports... ==> default: Clearing any previously set network interfaces... ==> default: Preparing network interfaces based on configuration... default: Adapter 1: nat ==> default: Forwarding ports... default: 22 (guest) => 2222 (host) (adapter 1) ==> default: Booting VM... ==> default: Waiting for machine to boot. This may take a few minutes... default: SSH address: 127.0.0.1:2222 default: SSH username: vagrant default: SSH auth method: private key default: Warning: Remote connection disconnect. Retrying... default: Warning: Remote connection disconnect. Retrying... ==> default: Machine booted and ready! GuestAdditions 5.0.20 running --- OK. ==> default: Checking for guest additions in VM... ==> default: Rsyncing folder: /cygdrive/e/cygwin/home/hoshikouki/ => /vagrant ==> default: Machine already provisioned. Run `vagrant provision` or use the `--provision` ==> default: flag to force provisioning. Provisioners marked to run always will still run.
以下コマンドで動作確認。
$ vagrant ssh
rsync を使って共有する場所は、デフォルト設定では、カレントディレクトリになるっぽい。
実際に共有するフォルダは独自に設定したいので カレントディレクトリにある Vagrantfile に以下の設定を追加する。
config.vm.synced_folder "./vagrant_data/", "/vagrant"
さらなる応用的情報
ドキュメント
英語だけど、本家ということもあり最も信用できる情報。
Documentation - Vagrant by HashiCorp
オブジェクト返却メソッドの異常系実装
概要
今回は、メソッド仕様の話。
オブジェクト値を返却するメソッドにおいて、入力値・プログラム状態によって異常な結果になったときにそれを示したい。
その方法として、以下の3通りが考えられる。
- null 返却
- 例外発生
- NULL オブジェクト返却 (参考:サルでもわかる 逆引きデザインパターン 第4章 逆引きカタログ その他 Nullオブジェクト)
これらの使いどころやそれぞれの利点について記述する。
詳細内容
実装内容
コンソールアプリケーションでユーザが入力した文字列からコマンド(コード内に定義)を実行する。
実行例
ls カレントのファイルリスト出力 ls /usr/local/bin /usr/local/bin ディレクトリのファイルリスト出力 rm /usr/local/bin /usr/local/binの削除 aaa 不正なコマンド aaa
基本実装
※ この後実装するため getCommandメソッドを空実装にしている。
package com.example1; import java.io.BufferedReader; import java.io.IOException; import java.io.InputStreamReader; public class Main { /** * コマンド定義. * */ public static enum Command { ls { @Override public void execute(String... params) { if(params.length == 1) { System.out.println("カレントのファイルリスト出力"); }else { System.out.println(params[1] + " ディレクトリのファイルリスト出力"); } } }, rm { @Override public void execute(String... params) { if(params.length > 1) { System.out.println(params[1] + "の削除"); } } }; public abstract void execute(String... params); } /** * メインロジック.標準入力からコマンドを入力して,登録された処理を実行する. */ public static void main(String[] args) throws IOException { BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); String line; while ((line = reader.readLine()) != null && !line.isEmpty()) { String[] elements = line.split(" "); getCommand(elements[0]).execute(elements); } } /** * 入力文字列から処理するコマンドを選択する. * @param cmd コマンド文字列 * @return コマンド実体 */ public static Command getCommand(String cmd) { return null; // TODO: 空実装 } }
getCommandメソッドの異常系処理、それに伴うロジック部の対応
登録されていないコマンドを指定した場合の処理を3通りの方法を実装する。
null を返却する場合
- getCommandの修正
public static Command getCommand(String cmd) { for(Command c : Command.values()) { if(c.name().equals(cmd)) { return c; } } return null; }
- ロジック部修正
public static void main(String[] args) throws IOException { BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); String line; while ((line = reader.readLine()) != null && !line.isEmpty()) { String[] elements = line.split(" "); Command cmd = getCommand(elements[0]); if(cmd != null) { cmd.execute(elements); }else { System.out.println("不正なコマンド " + elements[0]); } } }
例外を発生させる場合
- getCommandの修正
public static Command getCommand(String cmd) { for(Command c : Command.values()) { if(c.name().equals(cmd)) { return c; } } throw new IllegalArgumentException(cmd + " is not defined."); }
- ロジック部修正
public static void main(String[] args) throws IOException { BufferedReader reader = new BufferedReader(new InputStreamReader(System.in)); String line; while ((line = reader.readLine()) != null && !line.isEmpty()) { String[] elements = line.split(" "); try { getCommand(elements[0]).execute(elements); }catch (IllegalArgumentException e) { System.out.println("不正なコマンド " + elements[0]); } } }
NULL オブジェクトを返却する場合
- NULLオブジェクトの定義
public static enum Command { ls { @Override public void execute(String... params) { if(params.length == 1) { System.out.println("カレントのファイルリスト出力"); }else { System.out.println(params[1] + " ディレクトリのファイルリスト出力"); } } }, rm { @Override public void execute(String... params) { if(params.length > 1) { System.out.println(params[1] + "の削除"); } } }, // NULL オブジェクト追加 UNDEFINED { @Override public void execute(String... params) { System.out.println("不正なコマンド " + params[0]); } }; public abstract void execute(String... params); }
- getCommandメソッド修正
public static Command getCommand(String cmd) { for(Command c : Command.values()) { if(c.name().equals(cmd)) { return c; } } return Command.UNDEFINED; }
- ロジック部修正
変更不要
それぞれの実装利点/欠点
null 返却
- 利点
- 結果が存在しないことを意図的に示せる。
- オブジェクトを作成しないため、メモリ領域の節約になる。
- 欠点
例外発生
- 利点
- 欠点
NULL オブジェクト返却
- 利点
- null チェックが必要ないため、利用者のコードがシンプルになる。
- 関連した処理に格納されるため、コードが見やすくなる
- 利用者のコードが複数あっても、お決まりの処理の記述が其々で不要なため、冗長性がなくなり保守性が向上する。
- 欠点
- 事前に定義する必要がある。
まとめ
null 返却の利点は基本的に大きな利点にならないため、意図的に null を返す場合は少ない。
また、null を返すことは思わぬバグを生む可能性があるため余程の意図がない限り行うべきではない。
基本的には、NULL オブジェクトで実装する方が保守性が良くなる。
しかし、全メソッドに NULL オブジェクトを作成しても、多くの NULL オブジェクト定義ができるだけで、あまり効果はない。
つまり、それほど重要でない処理にまでこのような実装をする必要はない。
例外を返す場合、その処理が「本質的にどういう処理ものであるべきか」に基づいて決定すべき。
その処理が仕様として、起こりえなかったり・明らかに不自然であれば、例外で実装するのが良い。
例外仕様設計 - Status Code 303 - See Other
また、異常時に返す値・その意図をドキュメントに示す方が良い(特に null を返す場合)。
そして、これらを意識することによって複数人開発においては以下の利点が見込まれる。
- バグの少ない品質の良いコード
- デバッグに要する時間が少ない保守面で優れたコード
- 開発者に異常系を意識したコーディングの促進
一通りコードが書けるようになった人は、次はメソッド仕様として
このようなことを考えてコーディングできるようにしてみよう!
if-else 文と条件演算子(?:)の使い分け
概要
プログラミングを行ううえで、複数の選択があり基本的にどちらでも実装できる処理は数多くある。
これらは常にどっちを使うではなく、これらはプログラムが対象とする処理の内容に応じて使い分けるべきである。
今回は、その中でも分岐を表す方法として if-else 文と条件演算子の使い分けについて記述する。
詳細説明
記述法の違い
ここでは、ある条件に応じて、文字列変数 val を分岐させる処理を記述する。
if-else文
boolean condition = true; // ここに処理を分ける基準(条件式) string val = null; if(condition) { // 真の場合の処理 val = "真の場合の値"; }else { // 偽の場合の処理 val = "偽の場合の値"; }
条件演算子
boolean condition = true; // ここに処理を分ける基準(条件式) string val = condition ? "真の場合の値" : "偽の場合の値"; // 値を分岐
どっちを使うべきか?
if-else 文は処理を分岐させることができ、条件演算子は値を分岐させるために用いる。
そして、一般的には if-else 文の方が値の分岐に関わらず処理も記述できるためできる事が多い。
逆に 条件演算子にできないことは、値に応じた処理内容が変わるとき。
ここから、一つの使い分け条件ができる。
- 条件演算子
- データを選択する必要があるが、概念的にどの分岐があっても処理が同じ
- if-else 文
- 分岐によって、全く異なる処理を選択
例1(条件演算子を使うべきだと思う例)
使用している Linux OS から使用すべきパッケージマネージャを判別し、
パッケージをインストールさせようとしているとする。
今回は CentOS/RedHat系なら rpm、そうでなければ apt-get を利用するとする。
if-else文の場合
List<String> rpmUses = Arrays.asList("centos", "redhat"); String pkgmngr = null; if(rpmUses.contains(getOsName())) { pkgmngr = "rpm -ivh"; }else { pkgmngr = "apt-get install"; } installPackage(pkgmngr, "zabbix-server-mysql");
条件演算子の場合
List<String> rpmUses = Arrays.asList("centos", "redhat"); String pkgmngr = rpmUses.contains(getOsName()) ? "rpm -ivh" : "apt-get install"; installPackage(pkgmngr, "zabbix-server-mysql");
これらは、パッケージマネージャのプログラム名(文字列データ)を選択する責任を担っている。
概念的にやってることはどの分岐でも同じなので、後者の条件演算子で記述すべきと思う。
もし、RedHat の場合は別のパッケージマネージャ、例えば yum を使うことになったら、下記のようになる。
List<String> rpmUses = Arrays.asList("centos"); List<String> yumUses = Arrays.asList("redhat"); String os = getOsName(); String pkgmngr = rpmUses.contains(os) ? "rpm -ivh" : yumUses.contains(os) ? "yum install" : "apt-get install"; installPackage(pkgmngr, "zabbix-server-mysql");
ここで、ネストするときは行を分けて記述すると処理内容が分かりやすい。
(よく条件演算子は可読性が悪いというけれど、書式を工夫すれば問題ないと思う)
しかしこれ以上増やすと見苦しいソースコードになるので、3~4個くらいが限界か。
それ以上の分岐を書くときは、列挙型などを使用して記述する方が良い。
試しに、fedora のときは dnf というパッケージマネージャを利用することにすると。
私なら、処理内容は次のように修正する。
まず、各 OS の列挙型に使用するパッケージマネージャ情報を定義。
private static enum LinuxOS { CENT_OS("centos", "rpm -ivh"), RED_HAT("redhat", "yum install"), FEDORA("fedora", "yum install"), OTHER("other", "apt-get install"); private String os; private String pkgmngr; private LinuxOS(String os, String pkgmngr) { this.os = os; this.pkgmngr = pkgmngr; } static LinuxOS get(String osName) { for(LinuxOS linux : values()) { if(linux.os.equals(osName)) { return linux; } } return OTHER; } }
パッケージマネージャを取得するロジック。
String pkgmngr = LinuxOS.get(getOsName()).pkgmngr;
installPackage(pkgmngr, "zabbix-mysql");
ロジック自体の処理が見辛くなることはなくなるし、今後新しいパッケージマネージャが増えても列挙型を増やすだけで対応可能。
また、OS で使用するパッケージマネージャを変更したければ、OS の列挙型の中身を修正するだけで対応できる。
例2 (if文を使うべきだと思う例)
ユーザログイン画面でパスワード認証するページを想定する。
認証に成功すればメンバーページに遷移し、逆に失敗すれば認証ページを再び表示する。
if-else文の場合
String id = "フォームから入力"; String pwd = "フォームから入力"; if(pwd.equals(getPassword(id))) { gotoNextPage("http://www.xxxxxxxxxx.com/member"); }else { gotoNextPage("http://www.xxxxxxxxxx.com/login"); }
条件演算子の場合
String id = "フォームから入力"; String pwd = "フォームから入力"; String nextUrl = pwd.equals(getPassword(id)) ? "http://www.xxxxxxxxxx.com/member" : "http://www.xxxxxxxxxx.com/login"; gotoNextPage(nextUrl);
この例では、認証失敗・成功で表示ページを切り替えるだけであるから、データの分岐に見えるかもしれない。
しかし、個人的には、この場合はif文で実装にすべきだと思っている。
なぜなら、分岐による処理の内容は本質に異なるから。
成功時に処理したい内容、認証失敗時に処理したい内容、これらは当然異なる処理になりやすい。
例えば、セキュリティ対策の一環として、あまりにログイン処理失敗が多い場合はログに記録しておきたい場合もあるし、
ログインに成功すれば、その場でセッションを新しくする処理も必要になる。
これらは、処理が本質的に異なるため条件演算子で対応すると複雑になりやすい。
以下は、仮に認証失敗時にログを取得する場合をさきほどの実装から追加した場合。
String id = "フォームから入力"; String pwd = "フォームから入力"; if(pwd.equals(getPassword(id))) { gotoNextPage("http://www.xxxxxxxxxx.com/member"); }else { writeLog(new Date() + " id->" + id); // 一行追加 gotoNextPage("http://www.xxxxxxxxxx.com/login"); }
String id = "フォームから入力"; String pwd = "フォームから入力"; if(!pwd.equals(getPassword(id))) { writeLog(new Date() + " id->" + id); // 認証失敗時、結局if文を使う } String nextUrl = pwd.equals(getPassword(id)) ? "http://www.xxxxxxxxxx.com/member" : "http://www.xxxxxxxxxx.com/login"; gotoNextPage(nextUrl);
おまけに条件演算子の実装は、失敗時に次に遷移するページを表示する前に
ログを出力するということが分かり辛いと思う。(前者に比べて)
この処理は端的に言うと「ログインが成功したときは~~、失敗したなら~~。」
というログインが成功したかが基準となり、どちらかの処理が選択される構造。
これを端的に表現できるのは、if文の強みでもある。
まとめ
条件演算子はダメで if-else 文のみという現場もあるらしいが、ナンセンスな話だと思う。
たしかに条件演算子は書き方によっては複雑になるが、フォーマットを工夫すれば見やすくなる。
なにより、分岐が多くなれば条件演算子に関わらず、見辛くなるのは if-else 文もあまり変わらない。
今回は if-else 文と条件演算子の違いについて記述したが、これらですら書き方一つでコードの読みやすさは変わる。
文法レベルだけの解釈だけでなく、現在書いている処理の意味に応じて柔軟に対応できた方が良いだろう。
このようなことでも、意識してプログラミングできる/できないが、プログラマとして実力差につながると思う。
謝辞
これらの記事を書くきっかけを作ってくれた、H氏。いつもいい刺激を頂きありがたい限り。
Seasar2 (導入編)
概要
今回は、DI コンテナという少し特殊な技術を用いる。
この技術を使うと、プログラムをコンパイルせずに、プログラム外部にあるリソースファイルを使いプログラムの挙動を制御できる。
また、デザインパターンで言う Factory や Singleton パターンを容易に実装できるため、
オブジェクトのライフサイクルに気を取られず、どのようなクラスを作成するかに注力できるようになる。
DI って?
プログラミングのスタイルとして、まずインタフェースを決定し、その後詳細を実装していくスタイルがある。
このスタイルは、インタフェースでコンポーネントの仕様を決め、それぞれの仕様に従ったクラスを実装するという
流れでプログラミングを行うため、各コンポーネントが互いに依存しない(疎な)コンポーネント群になりやすい。
そして、この考えを発展させたものとして DI (Dependency Injection) という設計パターンがある。
これは、それぞれのコンポーネント間が疎になることにより、コンポーネントを自由に取り替えることができるようになる。
そのため、どのコンポーネントを使うかをプログラム内で記述するのではなく、外部リソースを使って決定させるようにする。
これによって、外部リソースを変更するだけで、プログラムをコンパイルし直さなくても、プログラムの挙動を変えることができる。
これによって、以下の利点が生まれる。
- コンポーネントの再利用促進
- オブジェクト使用コードとオブジェクト生成コードの分離
- テスト単純化
- 保守性向上
今回用いる DI コンテナ
Java では、有名なものには Spring DI, Dagger, Google Guice などがあるらしいが、
参考:Dependency Injection Options For Java | Keyhole Software
今回は Seasar2 を使う。(Seasar2 - Seasar2)
Seasar2 は、世界的に見るとシェアは低く、新規機能開発も現時点では終了している(バグ改修のみ)ため、
今ある以上のことが今後できる見込みはない。
しかし、
- 少ない設定で使用できる
- 専用プラグインが充実している
- 国産のため日本語文献が多い
といった利点があるため、規模の小さい開発や DI の実践演習としては有効な選択肢になりやすい。
なお、Searsar2 では、DI コンテナ以外にも、DB連携機能、アスペクト指向プログラミングなどの機能も提供している。
導入方法
日本語版の Windows のEclipse (Mars, ver4.5.1)を使用している場合を示す。
(画像は別環境でのスクリーンショットなため、Mac 英語版ですが...)
SeaSar2 用のプラグインの導入
次のプラグインを導入。
Eclipse のツールバーより、 [ヘルプ] -> [新規ソフトウェアのインストール...]を選択。
上記テキストボックスの「作業対象」に http://eclipse.seasar.org/updates/3.3/ を追加する。
そして、以上から、Dolteng, Kijimuna, SAStruts Plugin, Resource Synchronizer をインストールする。
なお、SAStruts Plugin のインストールがうまくいかなかった場合(私はなんかエラーが出た...)
http://download.eclipse.org/releases/mars/" ← Eclipse のバージョンによってURL 変える感じ。
を対象に入れて、「Web, XML, Java EE and OSGi Enterprise Development」をインストールすると、
SAStruts Plugin もインストールできた。
参考:SAStrutsPlugin がインストールできない場合の対応方法 - KusoBoze is here.
次に、作業対象に「http://eclipse.seasar.org/updates/3.2/」を追加する。
そして、DbLauncher をインストールする。
ライブラリ追加
あとは、Seasar2 - Downloads にアクセスして、
S2Tiger は便利な拡張機能があるので、入れておいた方が良さそう。
また、DBを使うなら S2JDBC-GEN も入れた方が良い。
インストール方法:Seasar - DI Container with AOP -
これで導入フェーズは終了。
次回からはサンプルの構築に移る予定。
参考文献
- 作者: 竹添直樹
- 出版社/メーカー: 翔泳社
- 発売日: 2010/04/20
- メディア: 大型本
- 購入: 10人 クリック: 270回
- この商品を含むブログ (31件) を見る
Dropbox API を使ってみる
概要
このツールは、様々なデバイス間のファイル変更を自動でマージしてくれる他、
リビジョンも保存するため、間違って上書きした場合などに、前回のファイルを復帰することができる。
また、Dropbox は記録領域をアプリ動作環境以外でも共有できるため、使用ユーザはその情報をどこからでも自由に参照できる。
導入
本家にチュートリアルがあるため、手順はそれほど難しくない。
しかし、英語なので得意でない人は、覚悟がいるかも。(それほど難しくない)
Dropbox - Developers
ライブラリ導入
API は、バージョン1, 2 の2つ存在する。新しい方の v2 を今回は用いる。
Maven 使っている人は、以下を pom.xml に追加する。
<dependency> <groupId>com.dropbox.core</groupId> <artifactId>dropbox-core-sdk</artifactId> <version>2.0-beta-5</version> </dependency>
(上記はDropbox 本家の内容を引用。2016/3/3 から、正式版ライブラリ 2.0.0 がリリースされてます。)
ビルドパスだけで設定したい人は、Maven レポジトリ(Maven Repository: Search/Browse/Explore)
から以下の jarファイル をダウンロードしてビルドパスに加える。
JSON処理系ライブラリ
- jackson-core-2.7.1.jar
- jackson-annotations-2.5.4.jar
- jackson-databind-2.5.4.jar
その他依存ライブラリ
- animal-sniffer-annotations-1.10.jar
- okhttp-2.5.0.jar
- okio-1.6.0.jar
app登録
Dropbox のアカウントがない人は、まず作成。
本日時点では、メールアドレスを使って無料で作成できる。
次に、Dropbox API を使用するアプリの登録する。
Dropbox の Developer サイト(Dropbox - Developers) のメニューから【My apps】を選択。
右上のボタン【Create app】からアプリ登録をする。内容はそれほど難しくないため設定内容は割愛。
設定ファイル
プログラムから Dropbox API を使用するのに必要な情報は次の2つ。
- アプリ名
- トークン文字列 (アプリ詳細の settings タブ /OAuth 2 /Generated access token /【Generate】ボタンを押して作成)
なお、これらがあると Dropbox API をどこでも使用できるため、情報管理には気を使うこと。
この部分を dropbox.properties に記述。
dropbox.app.name = dropbox.access.token =
コード実装
ほぼ機能として作り込まれているため、そのままロジックに記述。今回の実装内容と動きは以下の通り。
- API と通信するクライアント作成
- Dropbox の現在の最大容量・使用量の表示
- フォルダ作成 (+フォルダ内にファイルが存在しないか確認)
- ファイルをアップロード (+フォルダ内にファイルが作られたこと確認)
- 10秒間スレッドスリープ (本来不要。リビジョンの更新日時を分かりやすくするため)
- 別ファイルを同名で上書きアップロード (+フォルダ内にあるアップロードファイルは1つであること確認)
- アップロードしたファイルのリビジョン表示 (+リビジョンが複数ある(サイズ/更新時間が異なる)ことを確認)
- アップロードしたファイルをダウンロード
- 最初に作成したフォルダの削除
package api.dropbox; import java.io.File; import java.io.FileInputStream; import java.io.FileOutputStream; import java.io.IOException; import java.util.List; import com.dropbox.core.DbxException; import com.dropbox.core.DbxRequestConfig; import com.dropbox.core.v2.DbxClientV2; import com.dropbox.core.v2.files.FileMetadata; import com.dropbox.core.v2.files.Metadata; import com.dropbox.core.v2.files.WriteMode; import resources.properties.Property; public class Main { public static void main(String[] args) throws DbxException, IOException, InterruptedException { Property property = new Property("dropbox"); DbxRequestConfig config = new DbxRequestConfig(property.getString("dropbox.app.name"), "ja_JP"); DbxClientV2 client = new DbxClientV2(config, property.getString("dropbox.access.token")); System.out.println("Capacity: " + client.users().getSpaceUsage().getAllocation().getIndividualValue().getAllocated() / 1024 / 1024 + " MB"); System.out.println("Usage: " + client.users().getSpaceUsage().getUsed() / 1024 / 1024 + " MB"); System.out.println("Create Folder /test ---------"); client.files().createFolder("/test"); // 既に存在していると例外発生 System.out.println("Show file list under /test ---------"); for (Metadata metadata : client.files().listFolder("/test").getEntries()) { System.out.println(metadata.getName()); } System.out.println("Upload /test/sample.jar ---------"); FileInputStream fileStream = new FileInputStream(new File("./lib/dropbox/okhttp-2.5.0.jar")); client.files().uploadBuilder("/test/sample.jar").withMode(WriteMode.OVERWRITE).uploadAndFinish(fileStream); System.out.println("Show file list under /test ---------"); for (Metadata metadata : client.files().listFolder("/test").getEntries()) { System.out.println(metadata.getName()); } System.out.println("Sleep 10 seconds......please wait a moment."); Thread.sleep(10000); System.out.println("Overwrite /test/sample.jar ---------"); FileInputStream fileStream2 = new FileInputStream(new File("./lib/dropbox/okio-1.6.0.jar")); client.files().uploadBuilder("/test/sample.jar").withMode(WriteMode.OVERWRITE).uploadAndFinish(fileStream2); System.out.println("Show file list under /test ---------"); for (Metadata metadata : client.files().listFolder("/test").getEntries()) { System.out.println(metadata.getName()); } System.out.println("Show file list under /test ---------"); for (Metadata metadata : client.files().listFolder("/test").getEntries()) { System.out.println(metadata.getName()); } System.out.println("Show revision list about /test/sample.jar ---------"); List<FileMetadata> revisions = client.files().listRevisions("/test/sample.jar").getEntries(); for (FileMetadata filemetadata : revisions) { System.out.println("Name:" + filemetadata.getName() + "\tSize:" + filemetadata.getSize() + "\tDate:" + filemetadata.getClientModified()); } System.out.println("Download sample.jar into THIS project under /lib/sample.jar ---------"); FileOutputStream outputStream = new FileOutputStream(new File("./lib/dropbox/sample.jar")); client.files().download("/test/sample.jar").download(outputStream); System.out.println("Remove /test ---------"); client.files().delete("/test"); //削除対象がないと例外発生 } }
これによって、次のような出力が表示される。
Capacity: 3072 MB Usage: 3019 MB Create Folder /test --------- Show file list under /test --------- Upload /test/sample.jar --------- Show file list under /test --------- sample.jar Sleep 10 seconds......please wait a moment. Overwrite /test/sample.jar --------- Show file list under /test --------- sample.jar Show file list under /test --------- sample.jar Show revision list about /test/sample.jar --------- Name:sample.jar Size:65928 Date:Sat Mar 05 01:30:35 JST 2016 Name:sample.jar Size:317886 Date:Sat Mar 05 01:30:23 JST 2016 Download sample.jar into THIS project under /lib/sample.jar --------- Remove /test ---------
それに呼応して、Dropboxを起動していると、「test を追加しました」「sample.jar を作成しました」
「sample.jar を上書きしました」「2つのファイルを削除しました」などのメッセージが表示され、
標準出力をしなくても、Java アプリから Dropbox を操作できたことを確認できる。