9. پیوست‌ها

در اینجا توضیح می‌دهیم چگونه ابزارهای مورد استفاده در این سند را روی سیستم‌های ویندوز 7 یا 8 نصب کنید.

9.1. نصب JDK

جدیدترین نسخه، JDK، را می‌توان در URL [http://www.oracle.com/technetwork/java/javase/downloads/index.html] (اکتبر ۲۰۱۴) یافت. از این پس، پوشه نصب JDK را با نام <jdk-install> خطاب خواهیم کرد.

9.2. نصب Maven

Maven ابزاری برای مدیریت وابستگی‌ها در یک پروژه جاوا و موارد دیگر است. این ابزار در URL [http://maven.apache.org/download.cgi] در دسترس است.

آرشیو را دانلود و از حالت فشرده خارج کنید. ما پوشه نصب Maven را <maven-install> نام‌گذاری خواهیم کرد.

• در [1]، فایل [conf / settings.xml] مِیوِن را پیکربندی می‌کند؛

این فایل شامل خطوط زیر است:

  <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
-->

مقدار پیش‌فرض در خط ۴، اگر – مانند مورد من – {user.home} شما یک فاصله در مسیر خود داشته باشد (برای مثال، [C:\Users\Serge Tahé])، ممکن است برای برخی نرم‌افزارها، از جمله IntellijIDEA، مشکل ایجاد کند. بنابراین باید چیزی شبیه به این بنویسید:

  <!-- localRepository
   | The path to the local repository maven will use to store artifacts.
   |
   | Default: ${user.home}/.m2/repository
  <localRepository>/path/to/local/repo</localRepository>
  -->
<localRepository>D:\Programs\devjava\maven\.m2\repository</localRepository>

و در خط ۷، از استفاده از مسیری که شامل فاصله باشد خودداری کنید.

9.3. نصب STS (Spring Tool Suite)

ما قصد داریم SpringSource Tool Suite [http://www.springsource.com/developer/sts] را نصب کنیم، یک محیط Eclipse از پیش پیکربندی‌شده با پلاگین‌های متعدد مرتبط با چارچوب Spring و همچنین با پیکربندی Maven از پیش نصب‌شده.

• به وب‌سایت SpringSource Tool Suite بروید (STS) [1]، برای دانلود نسخه فعلی STS [2A] [2B]،

• فایل دانلود شده یک نصب‌کننده است که ساختار دایرکتوری را برای [3A] و [3B] ایجاد می‌کند. در [4]، فایل اجرایی راه‌اندازی می‌شود،
• در [5]، پنجره کاری IDE پس از بستن پنجره خوش‌آمدگویی ظاهر می‌شود. در [6]، پنجره سرورهای برنامه نمایش داده می‌شود،

• در [7]، پنجرهٔ سرورها. یک سرور ثبت شده است. این یک سرور سازگار با Tomcat VMware است.

شما باید مسیر نصب Maven را در STS مشخص کنید:

• در [1-2]، STS را پیکربندی کنید؛
• در [3-4]، یک نصب جدید Maven اضافه می‌شود؛

• در [5]، مسیر نصب Maven را مشخص کنید؛
• در [6]، جادوگر را تکمیل کنید؛
• در [7]، نصب جدید Maven به‌عنوان پیش‌فرض تنظیم می‌شود؛

• در [8-9]، مخزن محلی Maven را بررسی کنید – پوشه‌ای که وابستگی‌های دانلود شده در آن قرار می‌گیرند و جایی که STS آرتفکت‌های ساخته‌شده را قرار خواهد داد؛

9.4. نصب سرور Tomcat

سرورهای Tomcat در URL و [http://tomcat.apache.org/download-80.cgi] در دسترس هستند. مثال‌های این سند با نسخه 8.0.9 که در URL و [http://archive.apache.org/dist/tomcat/tomcat-8/v8.0.9/bin/] در دسترس است، آزمایش شده‌اند.

فایل زیپ مناسب برای ایستگاه کاری خود را دانلود کنید ([1]). پس از زیپ‌کردن، ساختار دایرکتوری ([2]) را دریافت خواهید کرد. پس از انجام این کار، می‌توانید این سرور را به سرورها در STS اضافه کنید:

• در [1-3]، یک سرور جدید به STS اضافه کنید؛ (برای باز کردن پنجره سرورها، به مسیر Window / Show view / Other / Server / Servers بروید)؛

• در [5]، یک سرور Tomcat 8 را انتخاب کنید؛
• در [6]، برای این سرور یک نام انتخاب کنید؛
• در [8]، پوشه نصب Tomcat را که قبلاً دانلود کرده‌اید، مشخص کنید؛
• در [9]، سرور جدید؛

• در [11-12]، سرور Tomcat 8 را راه‌اندازی کنید؛
• در [13-14]، پنجرهٔ لاگ آن؛
• در [15]، برای متوقف کردن آن؛

9.5. نصب [WampServer]

[WampServer] یک مجموعه نرم‌افزاری است برای توسعه روی PHP / MySQL / Apache روی یک ماشین ویندوز. ما از آن صرفاً برای SGBD و MySQL استفاده خواهیم کرد.

• در وب‌سایت [WampServer] [1]، نسخه مناسب [2] را انتخاب کنید؛
• فایل اجرایی دانلود شده یک نصاب (Installer) است. جزئیات مختلفی در طول نصب درخواست می‌شود. این موارد به MySQL مربوط نمی‌شوند. بنابراین می‌توان آنها را نادیده گرفت. پنجره [3] در پایان نصب ظاهر می‌شود. [WampServer] را اجرا کنید،

• وارد [4] شوید، و آیکون [WampServer] در نوار وظیفه در پایین سمت راست صفحه ([4]) نصب می‌شود؛
• و هنگامی که روی آن کلیک می‌کنید، منوی [5] ظاهر می‌شود. این به شما امکان می‌دهد تا سرور آپاچی و SGBD MySQL را مدیریت کنید. برای مدیریت این کار، از گزینه [PhpPmyAdmin] استفاده کنید؛
• که پنجرهٔ نمایش داده شده در زیر را باز می‌کند،

در اینجا جزئیات کمی در مورد نحوه استفاده از [PhpMyAdmin] ارائه می‌دهیم. این سند اطلاعات لازم را در صورت نیاز فراهم می‌کند.

9.6. نصب افزونه [Advanced Rest Client] کروم

در این سند، ما از مرورگر کروم گوگل (http://www.google.fr/intl/fr/chrome/browser/) استفاده می‌کنیم. ما افزونه [Advanced Rest Client] را به آن اضافه خواهیم کرد. شما می‌توانید این کار را به شرح زیر انجام دهید:

• با استفاده از مرورگر کروم به وب‌سایت [Google Web store] (https://chrome.google.com/webstore) بروید؛
• برنامه‌ی [Advanced Rest Client] را جستجو کنید:

• سپس برنامه برای دانلود در دسترس خواهد بود:

• برای دانلود آن، باید یک حساب گوگل ایجاد کنید. سپس [Google Web Store] از شما تأیید می‌خواهد [1]:

• در [2]، افزونهٔ اضافه شده تحت گزینهٔ [Applications] [3] در دسترس است. این گزینه در هر زبانهٔ جدیدی که ایجاد می‌کنید (CTRL-T) در مرورگر نمایش داده می‌شود.

9.7. مدیریت jSON « » در جاوا

برای توسعه‌دهنده به‌صورت شفاف، چارچوب [Spring MVC] از کتابخانه jSON [Jackson] استفاده می‌کند. برای نشان دادن اینکه jSON (JavaScript نشانهٔ شیء)، در اینجا برنامه‌ای را ارائه می‌دهیم که اشیاء را به jSON سریالیزه می‌کند و با انجام عملیات معکوس، رشته‌های حاصل از jSON را به اشیا اصلی بازسازی می‌کند.

کتابخانه «Jackson» به شما امکان می‌دهد تا ساختارهای زیر را بسازید:

• رشته jSON برای یک شیء: new ObjectMapper().writeValueAsString(object);
• یک شیء از یک رشته jSON: new ObjectMapper().readValue(jsonString, Object.class).

هر دو روش ممکن است یک IOException را فعال کنند. در اینجا یک مثال آمده است.

پروژهٔ بالا یک پروژهٔ Maven است که شامل فایل [pom.xml] زیر است:

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>

  <groupId>istia.st.pam</groupId>
  <artifactId>json</artifactId>
  <version>1.0-SNAPSHOT</version>

  <dependencies>
    <dependency>
      <groupId>com.fasterxml.jackson.core</groupId>
      <artifactId>jackson-databind</artifactId>
      <version>2.3.3</version>
    </dependency>
  </dependencies>
</project>

• خطوط ۱۲–۱۶: وابستگی که کتابخانه «Jackson» را وارد می‌کند؛

کلاس [Personne] به شرح زیر است:

package istia.st.json;

public class Personne {
    // داده‌ها
    private String nom;
    private String prenom;
    private int age;

    // تولیدکنندگان
    public Personne() {

    }

    public Personne(String nom, String prénom, int âge) {
        this.nom = nom;
        this.prenom = prénom;
        this.age = âge;
    }

    // امضا
    public String toString() {
        return String.format("Personne[%s, %s, %d]", nom, prenom, age);
    }

    // گیرنده و تنظیم‌کننده
...
}

کلاس [Main] به شرح زیر است:

package istia.st.json;

import com.fasterxml.jackson.databind.ObjectMapper;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

public class Main {
  //ابزار سریالی‌سازی/دسریالی‌سازی
  static ObjectMapper mapper = new ObjectMapper();

  public static void main(String[] args) throws IOException {
    // ایجاد یک شخص
    Personne paul = new Personne("Denis", "Paul", 40);
    //نمایش jSON
    String json = mapper.writeValueAsString(paul);
    System.out.println("Json=" + json);
    // نمونه سازی یک Person از JSON
    Personne p = mapper.readValue(json, Personne.class);
    //نمایش یک شخص
    System.out.println("Personne=" + p);
    //یک آرایه
    Personne virginie = new Personne("Radot", "Virginie", 20);
    Personne[] personnes = new Personne[]{paul, virginie};
    // نمایش JSON
    json = mapper.writeValueAsString(personnes);
    System.out.println("Json personnes=" + json);
    // فرهنگ
    Map<String, Personne> hpersonnes = new HashMap<String, Personne>();
    hpersonnes.put("1", paul);
    hpersonnes.put("2", virginie);
    // نمایش JSON
    json = mapper.writeValueAsString(hpersonnes);
    System.out.println("Json hpersonnes=" + json);
  }
}

اجرای این کلاس خروجی صفحه زیر را تولید می‌کند:

Json={"nom":"Denis","prenom":"Paul","age":40}
Personne=Personne[Denis, Paul, 40]
Json personnes=[{"nom":"Denis","prenom":"Paul","age":40},{"nom":"Radot","prenom":"Virginie","age":20}]
Json hpersonnes={"2":{"nom":"Radot","prenom":"Virginie","age":20},"1":{"nom":"Denis","prenom":"Paul","age":40}}

نکات کلیدی از مثال:

• شیء [ObjectMapper] مورد نیاز برای تبدیلات jSON / شیء: خط 11;
• تبدیل [Personne] → jSON: خط 17;
• تبدیل jSON → [Personne]: خط ۲۰؛
• استثنای [IOException] که توسط هر دو متد پرتاب شده است: خط ۱۳.

9.8. نصب [Webstorm]

[WebStorm] (WS) جانشین IDE و JetBrains برای توسعه HTML / CSS / JS. من آن را برای توسعهٔ برنامه‌های Angular عالی یافتم. وب‌سایت دانلود [http://www.jetbrains.com/webstorm/download/] است. این یک IDE پولی است، اما نسخه آزمایشی ۳۰ روزه آن برای دانلود در دسترس است. نسخه‌های شخصی و دانشجویی مقرون‌به‌صرفه‌ای نیز موجود است.

برای نصب کتابخانه‌های JS در یک برنامه، WS از ابزاری به نام [bower] استفاده می‌کند. این ابزار ماژولی از [node.js]، مجموعه‌ای از کتابخانه‌های JS است. علاوه بر این، کتابخانه‌های JS از یک مخزن گیت (Git) بازیابی می‌شوند که نیازمند یک کلاینت گیت (Git) روی کامپیوتری است که عملیات دانلود را انجام می‌دهد.

9.8.1. نصب [node.js]

وب‌سایت دانلود [node.js]، [http://nodejs.org/] است. فایل نصبی را دانلود کرده و سپس آن را اجرا کنید. در این مرحله کار دیگری وجود ندارد.

9.8.2. نصب ابزار [bower]

ابزار [bower] که امکان دانلود کتابخانه‌های جاوااسکریپت را فراهم می‌کند، را می‌توان به روش‌های مختلفی نصب کرد. ما آن را از خط فرمان نصب خواهیم کرد:

C:\Users\Serge Tahé>npm install -g bower
C:\Users\Serge Tahé\AppData\Roaming\npm\bower -> C:\Users\Serge Tahé\AppData\Roaming\npm\node_modules\bower\bin\bower
bower@1.3.7 C:\Users\Serge Tahé\AppData\Roaming\npm\node_modules\bower
├── stringify-object@0.2.1
├── is-root@0.1.0
├── junk@0.3.0
...
├── insight@0.3.1 (object-assign@0.1.2, async@0.2.10, lodash.debounce@2.4.1, req
uest@2.27.0, configstore@0.2.3, inquirer@0.4.1)
├── mout@0.9.1
└── inquirer@0.5.1 (readline2@0.1.0, mute-stream@0.0.4, through@2.3.4, async@0.8
.0, lodash@2.4.1, cli-color@0.3.2)

• خط ۱: دستور [node.js] که ماژول [bower] را نصب می‌کند. برای اینکه فرمان کار کند، فایل اجرایی [npm] باید در دایرکتوری PATH روی سیستم قرار داشته باشد (به پاراگراف زیر مراجعه کنید)؛

9.8.3. نصب [Git]

گیت یک سیستم کنترل نسخه نرم‌افزاری است. یک نسخه ویندوزی به نام [msysgit] وجود دارد که در URL و [http://msysgit.github.io/] در دسترس است. ما از [msysgit] برای مدیریت نسخه‌های برنامه خود استفاده نخواهیم کرد، بلکه صرفاً برای دانلود کتابخانه‌های JS که در سایت‌هایی مانند [https://github.com] یافت می‌شوند، استفاده خواهیم کرد که به یکپروتکل دسترسی ویژه، که توسط کلاینت [msysgit] ارائه می‌شود

ویزارد نصب مراحل مختلفی را ارائه می‌دهد، از جمله موارد زیر:

برای مراحل دیگر نصب، می‌توانید مقادیر پیش‌فرض ارائه‌شده را بپذیرید.

پس از نصب Git، بررسی کنید که فایل اجرایی در دایرکتوری PATH روی سیستم شما قرار دارد: [Panneau de configuration / Système et sécurité / Système / Paramètres systèmes avancés]:

متغیر PATH به این شکل است:

D:\Programs\devjava\java\jdk1.7.0\bin;D:\Programs\ActivePerl\Perl64\site\bin;D:\Programs\ActivePerl\Perl64\bin;D:\Programs\sgbd\OracleXE\app\oracle\product\11.2.0\client;D:\Programs\sgbd\OracleXE\app\oracle\product\11.2.0\client\bin;D:\Programs\sgbd\OracleXE\app\oracle\product\11.2.0\server\bin;...;D:\Programs\javascript\node.js\;D:\Programs\utilitaires\Git\cmd

اطمینان حاصل کنید که:

• مسیر نصب [node.js] موجود باشد (در اینجا D:\Programs\javascript\node.js);
• مسیر فایل اجرایی کلاینت Git موجود است (در اینجا D:\Programs\utilities\Git\cmd);

9.8.4. پیکربندی [Webstorm]

اکنون پیکربندی [Webstorm] را بررسی کنیم

در بالا، گزینه [1] را انتخاب کنید. فهرست ماژول‌های [node.js] که قبلاً نصب شده‌اند، به صورت [2] نمایش داده می‌شود. این فهرست باید فقط شامل خط [3] برای ماژول [bower] باشد، در صورتی که مراحل نصب قبلی را دنبال کرده باشید.

9.9. نصب یک شبیه‌ساز اندروید

شبیه‌سازهای ارائه‌شده همراه با SDK اندروید کند هستند که استفاده از آن‌ها را نامطلوب می‌کند. شرکت [Genymotion] یک شبیه‌ساز بسیار کارآمدتر ارائه می‌دهد. این شبیه‌ساز در URL [https://cloud.genymotion.com/page/launchpad/download/] در دسترس است.

(فوریه ۲۰۱۴).

برای دریافت نسخه‌ای جهت استفاده شخصی باید ثبت‌نام کنید. محصول [Genymotion] را به همراه ماشین مجازی VirtualBox دانلود کنید؛

سپس [Genymotion] را نصب و اجرا کنید. سپس یک ایمیج برای تبلت یا تلفن همراه دانلود کنید:

• در [1]، یک دستگاه مجازی اضافه کنید؛
• در [2]، یک یا چند دستگاه را برای نصب انتخاب کنید. می‌توانید لیست نمایش‌داده‌شده را با مشخص کردن نسخه اندروید مورد نظر ([3]) و مدل دستگاه ([4]) فیلتر کنید؛

• پس از اتمام دانلود، فهرستی از دستگاه‌های مجازی موجود برای آزمایش برنامه‌های اندروید خود را مشاهده خواهید کرد؛