?

EmaiSerivice.java

   import org.springframework.beans.factory.annotation.Autowired;
   import org.springframework.mail.SimpleMailMessage;
   //The org.springframework.mail package is the root level package for the Spring Framework’s email support. The central interface for sending emails is the MailSender interface; a simple value object encapsulating the properties of a simple mail such as from and to (plus many others) is the SimpleMailMessage class.
   import org.springframework.mail.javamail.JavaMailSender;//The org.springframework.mail.javamail.JavaMailSender interface adds specialized JavaMail features such as MIME message support to the MailSender interface (from which it inherits).
   import org.springframework.stereotype.Service;
   import org.springframework.util.StringUtils;
   //reference for springframework is showed in reference
   import io.pivotal.domain.Email;
    //in floder domain, 见上文

   @Service
   public class EmailService {

    @Autowired
    JavaMailSender javaMailSender;//from spring

    private Email email = new Email();// from domain

    public void sendEmail(String message) {
        if (email != null && email.isEmailConfigured() && !StringUtils.isEmpty(message)) {
            SimpleMailMessage mailMessage = new SimpleMailMessage();
            mailMessage.setTo(email.getToAddr()); 
            mailMessage.setReplyTo(email.getReplyToAddr()); //设置发信人
            mailMessage.setSubject(email.getSubject());//创建MIMEMessage
            mailMessage.setText(message);
            javaMailSender.send(mailMessage);
        }
    }
   //get and set
    public Email getEmail() {
        return email;
    }

    public void setEmail(Email email) {
        this.email = email;
    }

   }

EventSerivice.java

创建CloudFoundryClientService变量clientService.

函数：对于app来说

?

MetricService.java

/*
javax.management提供 Java Management Extensions 的核心类。 Java Management Extensions (JMXTM) API 是一个用于管理和监视的标准 API。典型用途包括： 查询并更改应用程序配置 累积有关应用程序行为的统计并使其可用 通知状态更改及错误状况。 JMX API 还可以作为解决方案的一部分来管理系统、网络等。 API 包括远程访问，因此，远程管理程序可以基于这些目的与正在运行的应用程序交互。
JMX API 的基本概念是 MBean。MBean 是表示资源的指定托管对象。它有一个管理接口，包括以下内容：
- 可以读取和/或写入的指定名称和类型的属性
- 可以调用的指定名称和类型的操作
- 可以由 MBean 发送的指定类型的通知。
*/
import javax.management.MBeanAttributeInfo;
//Describes an MBean attribute exposed for management.
import javax.management.MBeanInfo;
//Describes the management interface exposed by an MBean; that is, the set of attributes and operations which are available for management operations.
import javax.management.MBeanServerConnection;
//This interface represents a way to talk to an MBean server, whether local or remote.
import javax.management.ObjectInstance;
//Used to represent the object name of an MBean and its class name.
import javax.management.ObjectName;
//Represents the object name of an MBean, or a pattern that can match the names of several MBeans.

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Profile;
//Indicates that a component is eligible for registration when one or more specified profiles are active.
import org.springframework.stereotype.Service;
// http://docs.spring.io/spring/docs/current/javadoc-api/org/springframework/stereotype/Service.html
import org.springframework.util.StringUtils;

//in domain
import io.pivotal.domain.Attribute;
import io.pivotal.domain.CustomJobMetric;
import io.pivotal.domain.FixedAttribute;
import io.pivotal.domain.JobDetail;
import io.pivotal.domain.Metrics;
import io.pivotal.domain.VMMetric;

   -  Package javax.management http://docs.oracle.com/javase/7/docs/api/javax/management/package-summary.html

   -  Package org.springframework.context.annotation https://docs.spring.io/spring-framework/docs/current/javadoc-api/org/springframework/context/annotation/package-summary.html

   -  ```java
      public class ObjectInstance

  Used to represent the object name of an MBean and its class name. If the MBean is a Dynamic MBean the class name should be retrieved from the `MBeanInfo` it provides.

getAttributes() 返回所有属性的列表，这些属性的存在是根据 MBean 接口中是否存在 getName、isName 或 setName

函数

private CustomJobMetric populateCustomJobMetrics(ObjectName objectName, JobDetail job) throws Exception CustomJobMetric这个类可以在上文domain中找到，通过getAttributes()获取属性列表作为attributes。设定属性并返回customJobMetric。

private VMMetric populateVMMetrics(ObjectName objectName, JobDetail jobDetail) throws Exception 设定属性并返回VMMetric（in domain）

private void populateObject(Object obj, String key, String value) throws Exception ja反射使用：如果字段是私有的,那么必须要对这个字段设置setAccessible(true),之后用value设置obj

private void populateMetrics(ObjectInstance object, Metrics metrics) throws Exception 施行populateObject函数，设置metrics

public Metrics getMetrics() 通过queryMBeans （Gets MBeans controlled by the MBean server. https://docs.oracle.com/javase/7/docs/api/javax/management/MBeanServerConnection.html）获取object信息

https://github.com/cloudfoundry/cf-java-client Cloud Foundry Java Client

函数：

public List getOrgs() 通过CloudFoundryClient获取organization信息并返回。

public Integer getTotalOrgs() 通过CloudFoundryClientService获取organization总数。

public Integer getTotalRoutes()通过CloudFoundryClientService获取routes总数。

public Integer getTotalServiceBrokers()获得service_brokers的个数。

public Integer getTotalServices()获得service的总个数。

public Integer getTotalServiceInstances()获得service_instances的总个数。

public List getSpaces()通过CloudFoundryClient获取spaces信息并返回。

public Integer getTotalSpaces() 获取spaces个数。

public List getTotals() 返回的list的类型total是domain里的，这里通过各类Serivice存入了Orgs, Spaces, Users, Buildpacks,Serbices, Service Brokers, Service Instances, App Create Events, App Delete Events, App Authorized SSH Events,App UnAuthorized SSH Events, App Start Events, App Stop Events, App Update Events, App Crash Events的总数信息。调用populateAppCounts（）（这个函数在ApplicationService中可以找到，见上文）,计算并增加App Count, AI’s Count, Running AI’s Count, Diego Apps Count 以及 Warden Apps Count到 totals。

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
//以下import可以在domain里找到（见上文domain）
import io.pivotal.domain.CloudUser;
import io.pivotal.domain.Metadata;
import io.pivotal.domain.UserEntity;
import io.pivotal.domain.Users;

public Users getAllUsers()通过CloudFoundryClientService（见上文）获取user信息并返回user（类型见上文domain）

public Integer getTotalUsers()调用CloudFoundryClientService（见上文）中getTotalResults获取user总数信息

private Users getCloudUsers(List<>> allResources)从allResources通过Users中addCloudUser获取云用户信息并返回user

private CloudUser getCloudUser(Map resource)从resource里通过CloudFoundryClientService（见上文）中getMeta()与getEntity获取并设定云用户信息，并且返回云用户。

private UserEntity getEntity(Map resource) 设定userEntity信息并返回。

controller: Modified the code to skip ssl validation for jmx

https://github.com/pivotalservices/foundation-metrics/tree/master/metrics/src/main/java/io/pivotal/controller

package io.pivotal.controller;
import java.util.List;// be used to insert the required placeholders and pass in the values during the statement execution.
/*
1. springframework.beans is in https://github.com/spring-projects/spring-framework/tree/master/spring-beans
2. springframework.web is in https://github.com/spring-projects/spring-framework/tree/master/spring-web/src/main/java/org/springframework/web
3. 
*/
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RestController;

import io.pivotal.domain.Application;
import io.pivotal.service.ApplicationService;
@RestController
@RequestMapping(value = "apps")

public class ApplicationController {

    @Autowired
    ApplicationService applicationService;

    @CrossOrigin
    @RequestMapping(method=RequestMethod.GET)
    public List getApps() {
        return applicationService.getApplications();
    }
}

? public List getApps()返回一个Application的列表

package io.pivotal.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Profile;

import org.springframework.web.bind.annotation.CrossOrigin;
//Marks the annotated method or type as permitting cross origin requests.
import org.springframework.web.bind.annotation.RequestMapping;
//Annotation for mapping web requests onto specific handler classes and/or handler methods.
import org.springframework.web.bind.annotation.RequestMethod;
//Java 5 enumeration of HTTP request methods.
import org.springframework.web.bind.annotation.RestController;
//A convenience annotation that is itself annotated with @Controller and @ResponseBody.

//domain.Metrics 和 service.MetricService 是相对路径，可以在pivatolservices里（io/pivotal）中找到
import io.pivotal.domain.Metrics;
import io.pivotal.service.MetricService;

@Profile("jmx")
// The @Profile annotation allows you to indicate that a component is eligible for registration when one or more specified profiles are active. Using our example above, we can rewrite the dataSource configuration as follows:

@RestController
//Creating REST Controllers with the @RestController annotation
@RequestMapping(value = "metrics")
//You use the @RequestMapping annotation to map URLs such as /appointments onto an entire class or a particular handler method. 
public class MetricsController {
    @Autowired
    MetricService metricService;

    @CrossOrigin
    @RequestMapping(method = RequestMethod.GET)
    public Metrics getAllMetrics() {
        Metrics metrics = metricService.getMetrics();
        return metrics;
    }
}

? public Metrics getAllMetrics()

OrgController.java

public List getOrgs()通过OrgService(见上文Service)获取organization信息并返回。

SettingsController.java

package io.pivotal.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
//Marks the annotated method or type as permitting cross origin requests.
import org.springframework.web.bind.annotation.RequestBody;
//Annotation indicating a method parameter should be bound to the body of the web request.
import org.springframework.web.bind.annotation.RequestMapping;
//Annotation for mapping web requests onto specific handler classes and/or handler methods.
import org.springframework.web.bind.annotation.RequestMethod;
//Java 5 enumeration of HTTP request methods.
import org.springframework.web.bind.annotation.RestController;
//A convenience annotation that is itself annotated with @Controller and @ResponseBody.

//domain.Email 和 service.EmailService 是相对路径，可以在domain和service中找到
import io.pivotal.domain.Email;
import io.pivotal.service.EmailService;

@RestController
@RequestMapping(value = "settings")
public class SettingsController {

@Autowired
EmailService emailService;

@CrossOrigin
@RequestMapping(value = "mail", method = RequestMethod.POST)
public Email configureEmail(@RequestBody Email email) {
    emailService.setEmail(email);
    return emailService.getEmail();
}

@CrossOrigin
@RequestMapping(value = "mail", method = RequestMethod.GET)
public Email getEmail() {
    return emailService.getEmail();
}

}

SpaceController.java

package io.pivotal.controller;

import java.util.List;

import org.cloudfoundry.client.lib.domain.CloudSpace;
//public class CloudSpace extends CloudEntity

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
//Marks the annotated method or type as permitting cross origin requests.
import org.springframework.web.bind.annotation.RequestMapping;
//Annotation for mapping web requests onto specific handler classes and/or handler methods.
import org.springframework.web.bind.annotation.RequestMethod;
//Java 5 enumeration of HTTP request methods.
import org.springframework.web.bind.annotation.RestController;
//A convenience annotation that is itself annotated with @Controller and @ResponseBody.

import io.pivotal.service.SpaceService;//in Service

@RestController
@RequestMapping(value = "spaces")
public class SpaceController {

@Autowired
SpaceService spaceService;

@CrossOrigin
@RequestMapping(method = RequestMethod.GET)
public List getSpaces() {
    return spaceService.getSpaces();
}
}

package io.pivotal.controller;

import java.util.List;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
//Marks the annotated method or type as permitting cross origin requests.
import org.springframework.web.bind.annotation.RequestMapping;
//Annotation for mapping web requests onto specific handler classes and/or handler methods.
import org.springframework.web.bind.annotation.RequestMethod;
//Java 5 enumeration of HTTP request methods.
import org.springframework.web.bind.annotation.RestController;
//A convenience annotation that is itself annotated with @Controller and @ResponseBody.

import io.pivotal.domain.Total;//in domain
import io.pivotal.service.TotalsService;//in service

@RestController
@RequestMapping(value = "totals")
public class TotalController {

@Autowired
TotalsService totalsService;

@CrossOrigin
@RequestMapping(method = RequestMethod.GET)
public List getTotals() {
    return totalsService.getTotals();
}

}

package io.pivotal.controller;

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.CrossOrigin;
//Marks the annotated method or type as permitting cross origin requests.
import org.springframework.web.bind.annotation.RequestMapping;
//Annotation for mapping web requests onto specific handler classes and/or handler methods.
import org.springframework.web.bind.annotation.RequestMethod;
//Java 5 enumeration of HTTP request methods.
import org.springframework.web.bind.annotation.RestController;
//A convenience annotation that is itself annotated with @Controller and @ResponseBody

import io.pivotal.domain.Users;//in domain
import io.pivotal.service.UserService;//in service

@RestController
@RequestMapping(value = "users")
public class UserController {

@Autowired
UserService userService;

@CrossOrigin
@RequestMapping(method = RequestMethod.GET)
public Users getUsers() {
    return userService.getAllUsers();
}
}