jp.ikedam.jenkins.plugins.updatesitesmanager

クラス ManagedUpdateSite

java.lang.Object

hudson.model.UpdateSite

jp.ikedam.jenkins.plugins.updatesitesmanager.DescribedUpdateSite

jp.ikedam.jenkins.plugins.updatesitesmanager.ManagedUpdateSite

すべての実装されたインタフェース:

hudson.ExtensionPoint, hudson.model.Describable<DescribedUpdateSite>, hudson.model.ModelObject, Serializable, jenkins.model.ModelObjectWithContextMenu

public class ManagedUpdateSite
extends DescribedUpdateSite

Extended UpdateSite to be managed in UpdateSitesManager. ManagedUpdateSite provides following features.

• can switch enabled/disabled.
• have a note field.
• can set a CA certificate for the signature of the site.

The CA certificate is written to a temporary file under ${JENKINS_HOME}/update-center-rootCAs/ . I think it is a better implementation to override UpdateSite#verifySignature, but it is private method. Re-implementing doPostBack results to re-implement whole the UpdateSite.

関連項目:

直列化された形式

ネストされたクラスの概要

ネストされたクラス

修飾子とタイプ	クラスと説明
static class	ManagedUpdateSite.DescriptorImpl Descriptor for this class.

クラスから継承されたネストされたクラス/インタフェース jp.ikedam.jenkins.plugins.updatesitesmanager.DescribedUpdateSite

DescribedUpdateSite.Descriptor

クラスから継承されたネストされたクラス/インタフェース hudson.model.UpdateSite

hudson.model.UpdateSite.Data, hudson.model.UpdateSite.Entry, hudson.model.UpdateSite.Plugin

インタフェースから継承されたネストされたクラス/インタフェース hudson.ExtensionPoint

hudson.ExtensionPoint.LegacyInstancesAreScopedToHudson

インタフェースから継承されたネストされたクラス/インタフェース jenkins.model.ModelObjectWithContextMenu

jenkins.model.ModelObjectWithContextMenu.ContextMenu, jenkins.model.ModelObjectWithContextMenu.MenuItem

フィールドの概要

クラスから継承されたフィールド hudson.model.UpdateSite

neverUpdate, signatureCheck

コンストラクタの概要

コンストラクタ

コンストラクタと説明
ManagedUpdateSite(String id, String url, boolean useCaCertificate, String caCertificate, String note, boolean disabled) Create a new instance

メソッドの概要

メソッド

修飾子とタイプ	メソッドと説明
hudson.util.FormValidation	doPostBack(org.kohsuke.stapler.StaplerRequest req) Process update-center.json.
hudson.util.FormValidation	doVerifySignature() Verify the signature of downloaded update-center.json.
String	getCaCertificate() Returns the CA certificate to verify the signature.
protected File	getCaCertificateFile() Returns the path to the CA certificate file.
String	getNote() Returns the note Note is only used for the displaying purpose.
boolean	isDisabled() Returns whether this site is disabled.
boolean	isUseCaCertificate() Returns whether to use CA certificate.
void	setCaCertificate(String caCertificate) Set the CA certificate to verify the signature.

クラスから継承されたメソッド jp.ikedam.jenkins.plugins.updatesitesmanager.DescribedUpdateSite

all, doConfigure, doContextMenu, doDelete, getAvailables, getDescriptor, getDisplayName, getPageUrl, getUpdates, getUpdateSite, hasUpdates, isDue, isEditable

クラスから継承されたメソッド hudson.model.UpdateSite

doInvalidateData, getConnectionCheckUrl, getData, getDataTimestamp, getDownloadUrl, getId, getJSONObject, getPlugin, getUrl, isLegacyDefault

クラスから継承されたメソッド java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

ManagedUpdateSite

@DataBoundConstructor
public ManagedUpdateSite(String id,
                                      String url,
                                      boolean useCaCertificate,
                                      String caCertificate,
                                      String note,
                                      boolean disabled)

Create a new instance

パラメータ:

id -

url -

useCaCertificate -

caCertificate -

note -

disabled -

メソッドの詳細

getCaCertificate

public String getCaCertificate()

Returns the CA certificate to verify the signature. This is useful when the UpdateSite is signed with a self-signed private key.

戻り値:

the CA certificate

setCaCertificate

public void setCaCertificate(String caCertificate)

Set the CA certificate to verify the signature. Mainly for testing Purpose.

isUseCaCertificate

public boolean isUseCaCertificate()

Returns whether to use CA certificate.

戻り値:

whether to use CA certificate

isDisabled

public boolean isDisabled()

Returns whether this site is disabled. When disabled, plugins in this site gets unavailable.

オーバーライド:

isDisabled クラス内 DescribedUpdateSite

戻り値:

the whether this site is disabled

getNote

public String getNote()

Returns the note Note is only used for the displaying purpose.

オーバーライド:

getNote クラス内 DescribedUpdateSite

戻り値:

the note

getCaCertificateFile

protected File getCaCertificateFile()

Returns the path to the CA certificate file. The file to store the CA certificate temporary.

戻り値:

the path to the CA certificate file

doPostBack

public hudson.util.FormValidation doPostBack(org.kohsuke.stapler.StaplerRequest req)
                                      throws IOException,
                                             GeneralSecurityException

Process update-center.json. If a CA certificate is set, write it to file and make it ready to verify the signature.

オーバーライド:

doPostBack クラス内 hudson.model.UpdateSite

パラメータ:

req -

戻り値:

FormValidation object

例外:

IOException

GeneralSecurityException

関連項目:

UpdateSite.doPostBack(org.kohsuke.stapler.StaplerRequest)

doVerifySignature

public hudson.util.FormValidation doVerifySignature()
                                             throws IOException

Verify the signature of downloaded update-center.json.

オーバーライド:

doVerifySignature クラス内 hudson.model.UpdateSite

戻り値:

FormValidation object.

例外:

IOException

関連項目:

UpdateSite.doVerifySignature()