138 lines
5.1 KiB
Go
138 lines
5.1 KiB
Go
/*
|
|
Copyright 2014 The Kubernetes Authors.
|
|
|
|
Licensed under the Apache License, Version 2.0 (the "License");
|
|
you may not use this file except in compliance with the License.
|
|
You may obtain a copy of the License at
|
|
|
|
http://www.apache.org/licenses/LICENSE-2.0
|
|
|
|
Unless required by applicable law or agreed to in writing, software
|
|
distributed under the License is distributed on an "AS IS" BASIS,
|
|
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
See the License for the specific language governing permissions and
|
|
limitations under the License.
|
|
*/
|
|
|
|
package runtime
|
|
|
|
// Note that the types provided in this file are not versioned and are intended to be
|
|
// safe to use from within all versions of every API object.
|
|
|
|
// TypeMeta is shared by all top level objects. The proper way to use it is to inline it in your type,
|
|
// like this:
|
|
// type MyAwesomeAPIObject struct {
|
|
// runtime.TypeMeta `json:",inline"`
|
|
// ... // other fields
|
|
// }
|
|
// func (obj *MyAwesomeAPIObject) SetGroupVersionKind(gvk *metav1.GroupVersionKind) { metav1.UpdateTypeMeta(obj,gvk) }; GroupVersionKind() *GroupVersionKind
|
|
//
|
|
// TypeMeta is provided here for convenience. You may use it directly from this package or define
|
|
// your own with the same fields.
|
|
//
|
|
// +k8s:deepcopy-gen=false
|
|
// +protobuf=true
|
|
// +k8s:openapi-gen=true
|
|
type TypeMeta struct {
|
|
// +optional
|
|
APIVersion string `json:"apiVersion,omitempty" yaml:"apiVersion,omitempty" protobuf:"bytes,1,opt,name=apiVersion"`
|
|
// +optional
|
|
Kind string `json:"kind,omitempty" yaml:"kind,omitempty" protobuf:"bytes,2,opt,name=kind"`
|
|
}
|
|
|
|
const (
|
|
ContentTypeJSON string = "application/json"
|
|
)
|
|
|
|
// RawExtension is used to hold extensions in external versions.
|
|
//
|
|
// To use this, make a field which has RawExtension as its type in your external, versioned
|
|
// struct, and Object in your internal struct. You also need to register your
|
|
// various plugin types.
|
|
//
|
|
// // Internal package:
|
|
// type MyAPIObject struct {
|
|
// runtime.TypeMeta `json:",inline"`
|
|
// MyPlugin runtime.Object `json:"myPlugin"`
|
|
// }
|
|
// type PluginA struct {
|
|
// AOption string `json:"aOption"`
|
|
// }
|
|
//
|
|
// // External package:
|
|
// type MyAPIObject struct {
|
|
// runtime.TypeMeta `json:",inline"`
|
|
// MyPlugin runtime.RawExtension `json:"myPlugin"`
|
|
// }
|
|
// type PluginA struct {
|
|
// AOption string `json:"aOption"`
|
|
// }
|
|
//
|
|
// // On the wire, the JSON will look something like this:
|
|
// {
|
|
// "kind":"MyAPIObject",
|
|
// "apiVersion":"v1",
|
|
// "myPlugin": {
|
|
// "kind":"PluginA",
|
|
// "aOption":"foo",
|
|
// },
|
|
// }
|
|
//
|
|
// So what happens? Decode first uses json or yaml to unmarshal the serialized data into
|
|
// your external MyAPIObject. That causes the raw JSON to be stored, but not unpacked.
|
|
// The next step is to copy (using pkg/conversion) into the internal struct. The runtime
|
|
// package's DefaultScheme has conversion functions installed which will unpack the
|
|
// JSON stored in RawExtension, turning it into the correct object type, and storing it
|
|
// in the Object. (TODO: In the case where the object is of an unknown type, a
|
|
// runtime.Unknown object will be created and stored.)
|
|
//
|
|
// +k8s:deepcopy-gen=true
|
|
// +protobuf=true
|
|
// +k8s:openapi-gen=true
|
|
type RawExtension struct {
|
|
// Raw is the underlying serialization of this object.
|
|
//
|
|
// TODO: Determine how to detect ContentType and ContentEncoding of 'Raw' data.
|
|
Raw []byte `protobuf:"bytes,1,opt,name=raw"`
|
|
// Object can hold a representation of this extension - useful for working with versioned
|
|
// structs.
|
|
Object Object `json:"-"`
|
|
}
|
|
|
|
// Unknown allows api objects with unknown types to be passed-through. This can be used
|
|
// to deal with the API objects from a plug-in. Unknown objects still have functioning
|
|
// TypeMeta features-- kind, version, etc.
|
|
// TODO: Make this object have easy access to field based accessors and settors for
|
|
// metadata and field mutatation.
|
|
//
|
|
// +k8s:deepcopy-gen=true
|
|
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
|
|
// +protobuf=true
|
|
// +k8s:openapi-gen=true
|
|
type Unknown struct {
|
|
TypeMeta `json:",inline" protobuf:"bytes,1,opt,name=typeMeta"`
|
|
// Raw will hold the complete serialized object which couldn't be matched
|
|
// with a registered type. Most likely, nothing should be done with this
|
|
// except for passing it through the system.
|
|
Raw []byte `protobuf:"bytes,2,opt,name=raw"`
|
|
// ContentEncoding is encoding used to encode 'Raw' data.
|
|
// Unspecified means no encoding.
|
|
ContentEncoding string `protobuf:"bytes,3,opt,name=contentEncoding"`
|
|
// ContentType is serialization method used to serialize 'Raw'.
|
|
// Unspecified means ContentTypeJSON.
|
|
ContentType string `protobuf:"bytes,4,opt,name=contentType"`
|
|
}
|
|
|
|
// VersionedObjects is used by Decoders to give callers a way to access all versions
|
|
// of an object during the decoding process.
|
|
//
|
|
// +k8s:deepcopy-gen:interfaces=k8s.io/apimachinery/pkg/runtime.Object
|
|
// +k8s:deepcopy-gen=true
|
|
type VersionedObjects struct {
|
|
// Objects is the set of objects retrieved during decoding, in order of conversion.
|
|
// The 0 index is the object as serialized on the wire. If conversion has occurred,
|
|
// other objects may be present. The right most object is the same as would be returned
|
|
// by a normal Decode call.
|
|
Objects []Object
|
|
}
|