@cparra/apexdocs 2.22.0 → 2.23.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.eslintrc.js +12 -12
- package/.github/workflows/close_stale.yml +22 -22
- package/.prettierrc.js +7 -7
- package/LICENSE +21 -21
- package/README.md +718 -682
- package/apexdocs.config.ts +13 -11
- package/docs/README.md +1 -1
- package/docs/restapi.json +589 -589
- package/docs/types/Classes/nspc.ChildClass.md +21 -18
- package/docs/types/Main/nspc.SampleClass.md +13 -13
- package/examples/force-app/main/default/classes/AnotherInterface.cls +16 -16
- package/examples/force-app/main/default/classes/ChildClass.cls +42 -41
- package/examples/force-app/main/default/classes/EscapedAnnotations.cls +5 -5
- package/examples/force-app/main/default/classes/GrandparentClass.cls +4 -4
- package/examples/force-app/main/default/classes/GroupedClass.cls +8 -8
- package/examples/force-app/main/default/classes/MemberGrouping.cls +17 -17
- package/examples/force-app/main/default/classes/ParentClass.cls +16 -16
- package/examples/force-app/main/default/classes/SampleClass.cls +166 -166
- package/examples/force-app/main/default/classes/SampleClass.cls-meta.xml +5 -5
- package/examples/force-app/main/default/classes/SampleClassWithoutModifier.cls +9 -9
- package/examples/force-app/main/default/classes/SampleInterface.cls +16 -16
- package/examples/force-app/main/default/restapi/SampleRestResource.cls +195 -195
- package/examples/force-app/main/default/restapi/SampleRestResourceToSkip.cls +35 -35
- package/examples/force-app/main/default/restapi/SampleRestResourceWithInnerClass.cls +24 -24
- package/examples/force-app/main/default/restapi/SampleRestResourceWithoutApexDocs.cls +15 -15
- package/examples/force-app/main/default/restapi/references/Reference1.cls +9 -9
- package/examples/force-app/main/default/restapi/references/Reference2.cls +9 -9
- package/examples/force-app/main/default/restapi/references/Reference3.cls +3 -3
- package/examples/force-app/main/default/restapi/references/Reference4.cls +3 -3
- package/examples/force-app/main/default/restapi/references/Reference5.cls +3 -3
- package/examples/force-app/main/default/restapi/references/Reference6.cls +6 -6
- package/examples/force-app/main/default/restapi/references/Reference7.cls +3 -3
- package/examples/includes/header.md +3 -3
- package/jest.config.js +5 -5
- package/lib/application/Apexdocs.d.ts +13 -13
- package/lib/application/Apexdocs.js +76 -76
- package/lib/cli/generate.d.ts +2 -2
- package/lib/cli/generate.js +130 -122
- package/lib/cli/generate.js.map +1 -1
- package/lib/index.d.ts +1 -1
- package/lib/index.js +17 -17
- package/lib/model/apex-bundle.d.ts +6 -6
- package/lib/model/apex-bundle.js +10 -10
- package/lib/model/apex-type-wrappers/ClassMirrorWrapper.d.ts +7 -7
- package/lib/model/apex-type-wrappers/ClassMirrorWrapper.js +13 -13
- package/lib/model/apex-type-wrappers/MethodMirrorWrapper.d.ts +7 -7
- package/lib/model/apex-type-wrappers/MethodMirrorWrapper.js +11 -11
- package/lib/model/inheritance.d.ts +8 -8
- package/lib/model/inheritance.js +2 -2
- package/lib/model/manifest-diff.d.ts +27 -27
- package/lib/model/manifest-diff.js +68 -68
- package/lib/model/manifest.d.ts +22 -22
- package/lib/model/manifest.js +46 -46
- package/lib/model/markdown-file.d.ts +16 -16
- package/lib/model/markdown-file.js +106 -106
- package/lib/model/markdown-generation-util/doc-comment-annotation-util.d.ts +8 -8
- package/lib/model/markdown-generation-util/doc-comment-annotation-util.js +43 -43
- package/lib/model/markdown-generation-util/field-declaration-util.d.ts +3 -3
- package/lib/model/markdown-generation-util/field-declaration-util.js +54 -62
- package/lib/model/markdown-generation-util/field-declaration-util.js.map +1 -1
- package/lib/model/markdown-generation-util/index.d.ts +3 -3
- package/lib/model/markdown-generation-util/index.js +19 -19
- package/lib/model/markdown-generation-util/method-declaration-util.d.ts +4 -4
- package/lib/model/markdown-generation-util/method-declaration-util.js +114 -114
- package/lib/model/markdown-generation-util/type-declaration-util.d.ts +3 -3
- package/lib/model/markdown-generation-util/type-declaration-util.js +81 -81
- package/lib/model/markdown-home-file.d.ts +11 -11
- package/lib/model/markdown-home-file.js +53 -53
- package/lib/model/markdown-type-file.d.ts +26 -26
- package/lib/model/markdown-type-file.js +133 -141
- package/lib/model/markdown-type-file.js.map +1 -1
- package/lib/model/openapi/apex-doc-types.d.ts +19 -19
- package/lib/model/openapi/apex-doc-types.js +4 -4
- package/lib/model/openapi/open-api-types.d.ts +93 -93
- package/lib/model/openapi/open-api-types.js +2 -2
- package/lib/model/openapi/open-api.d.ts +16 -16
- package/lib/model/openapi/open-api.js +33 -33
- package/lib/model/openapi/openapi-type-file.d.ts +7 -7
- package/lib/model/openapi/openapi-type-file.js +16 -16
- package/lib/model/outputFile.d.ts +10 -10
- package/lib/model/outputFile.js +28 -28
- package/lib/model/types-repository.d.ts +16 -16
- package/lib/model/types-repository.js +53 -53
- package/lib/service/apex-file-reader.d.ts +14 -14
- package/lib/service/apex-file-reader.js +45 -45
- package/lib/service/file-system.d.ts +14 -14
- package/lib/service/file-system.js +24 -24
- package/lib/service/file-writer.d.ts +6 -6
- package/lib/service/file-writer.js +33 -33
- package/lib/service/manifest-factory.d.ts +10 -10
- package/lib/service/manifest-factory.js +13 -13
- package/lib/service/metadata-processor.d.ts +3 -3
- package/lib/service/metadata-processor.js +16 -16
- package/lib/service/parser.d.ts +21 -21
- package/lib/service/parser.js +134 -134
- package/lib/service/state.d.ts +9 -9
- package/lib/service/state.js +19 -19
- package/lib/service/walkers/class-walker.d.ts +4 -4
- package/lib/service/walkers/class-walker.js +32 -32
- package/lib/service/walkers/class-walker.js.map +1 -1
- package/lib/service/walkers/enum-walker.d.ts +4 -4
- package/lib/service/walkers/enum-walker.js +10 -10
- package/lib/service/walkers/enum-walker.js.map +1 -1
- package/lib/service/walkers/interface-walker.d.ts +4 -4
- package/lib/service/walkers/interface-walker.js +14 -14
- package/lib/service/walkers/interface-walker.js.map +1 -1
- package/lib/service/walkers/walker-factory.d.ts +5 -5
- package/lib/service/walkers/walker-factory.js +20 -20
- package/lib/service/walkers/walker.d.ts +19 -16
- package/lib/service/walkers/walker.js +16 -9
- package/lib/service/walkers/walker.js.map +1 -1
- package/lib/settings.d.ts +64 -53
- package/lib/settings.js +88 -78
- package/lib/settings.js.map +1 -1
- package/lib/test-helpers/AnnotationBuilder.d.ts +12 -12
- package/lib/test-helpers/AnnotationBuilder.js +30 -30
- package/lib/test-helpers/ClassMirrorBuilder.d.ts +18 -18
- package/lib/test-helpers/ClassMirrorBuilder.js +53 -53
- package/lib/test-helpers/DocCommentAnnotationBuilder.d.ts +8 -8
- package/lib/test-helpers/DocCommentAnnotationBuilder.js +25 -25
- package/lib/test-helpers/DocCommentBuilder.d.ts +12 -12
- package/lib/test-helpers/DocCommentBuilder.js +37 -37
- package/lib/test-helpers/FieldMirrorBuilder.d.ts +18 -18
- package/lib/test-helpers/FieldMirrorBuilder.js +53 -53
- package/lib/test-helpers/MethodMirrorBuilder.d.ts +10 -10
- package/lib/test-helpers/MethodMirrorBuilder.js +36 -36
- package/lib/test-helpers/SettingsBuilder.d.ts +8 -8
- package/lib/test-helpers/SettingsBuilder.js +26 -26
- package/lib/transpiler/factory.d.ts +6 -6
- package/lib/transpiler/factory.js +31 -31
- package/lib/transpiler/file-container.d.ts +6 -6
- package/lib/transpiler/file-container.js +15 -15
- package/lib/transpiler/generator-choices.d.ts +1 -1
- package/lib/transpiler/generator-choices.js +2 -2
- package/lib/transpiler/markdown/class-file-generatorHelper.d.ts +8 -8
- package/lib/transpiler/markdown/class-file-generatorHelper.js +55 -55
- package/lib/transpiler/markdown/class-file-generatorHelper.js.map +1 -1
- package/lib/transpiler/markdown/docsify/docsify-docs-processor.d.ts +6 -6
- package/lib/transpiler/markdown/docsify/docsify-docs-processor.js +12 -12
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.d.ts +11 -10
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js +50 -27
- package/lib/transpiler/markdown/jekyll/jekyll-docsProcessor.js.map +1 -1
- package/lib/transpiler/markdown/markdown-transpiler-base.d.ts +11 -11
- package/lib/transpiler/markdown/markdown-transpiler-base.js +23 -23
- package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.d.ts +6 -6
- package/lib/transpiler/markdown/plain-markdown/plain-docsProcessor.js +13 -13
- package/lib/transpiler/openapi/open-api-docs-processor.d.ts +13 -13
- package/lib/transpiler/openapi/open-api-docs-processor.js +74 -74
- package/lib/transpiler/openapi/parsers/Builder.d.ts +16 -16
- package/lib/transpiler/openapi/parsers/Builder.js +29 -29
- package/lib/transpiler/openapi/parsers/MethodParser.d.ts +20 -20
- package/lib/transpiler/openapi/parsers/MethodParser.js +166 -166
- package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.d.ts +7 -7
- package/lib/transpiler/openapi/parsers/ParameterObjectBuilder.js +10 -10
- package/lib/transpiler/openapi/parsers/ReferenceBuilder.d.ts +39 -39
- package/lib/transpiler/openapi/parsers/ReferenceBuilder.js +225 -225
- package/lib/transpiler/openapi/parsers/RequestBodyBuilder.d.ts +10 -10
- package/lib/transpiler/openapi/parsers/RequestBodyBuilder.js +19 -19
- package/lib/transpiler/openapi/parsers/ResponsesBuilder.d.ts +7 -7
- package/lib/transpiler/openapi/parsers/ResponsesBuilder.js +21 -21
- package/lib/transpiler/processor-type-transpiler.d.ts +10 -10
- package/lib/transpiler/processor-type-transpiler.js +8 -8
- package/lib/transpiler/transpiler.d.ts +5 -5
- package/lib/transpiler/transpiler.js +26 -26
- package/lib/util/error-logger.d.ts +8 -8
- package/lib/util/error-logger.js +89 -89
- package/lib/util/logger.d.ts +21 -21
- package/lib/util/logger.js +57 -57
- package/lib/util/string-utils.d.ts +2 -2
- package/lib/util/string-utils.js +14 -14
- package/package.json +78 -78
- package/src/cli/generate.ts +8 -0
- package/src/model/markdown-generation-util/field-declaration-util.ts +3 -9
- package/src/model/markdown-type-file.ts +4 -10
- package/src/service/walkers/class-walker.ts +6 -7
- package/src/service/walkers/enum-walker.ts +0 -1
- package/src/service/walkers/interface-walker.ts +1 -1
- package/src/service/walkers/walker.ts +8 -1
- package/src/settings.ts +21 -0
- package/src/transpiler/markdown/class-file-generatorHelper.ts +2 -2
- package/src/transpiler/markdown/jekyll/jekyll-docsProcessor.ts +26 -3
- package/tsconfig.json +20 -20
- package/tslint.json +5 -5
- package/ROADMAP.md +0 -16
|
@@ -21,6 +21,9 @@ ChildClass
|
|
|
21
21
|
|
|
22
22
|
## Fields
|
|
23
23
|
|
|
24
|
+
### `private aPrivateString` → `String`
|
|
25
|
+
|
|
26
|
+
|
|
24
27
|
### `private privateStringFromChild` → `String`
|
|
25
28
|
|
|
26
29
|
|
|
@@ -48,6 +51,24 @@ This is a protected string, use carefully.
|
|
|
48
51
|
---
|
|
49
52
|
## Methods
|
|
50
53
|
### `public void doSomething()`
|
|
54
|
+
### `public void execute()`
|
|
55
|
+
|
|
56
|
+
Executes the command.
|
|
57
|
+
|
|
58
|
+
### `public String getValue()`
|
|
59
|
+
|
|
60
|
+
Returns a value based on the executed command.
|
|
61
|
+
|
|
62
|
+
#### Returns
|
|
63
|
+
|
|
64
|
+
|Type|Description|
|
|
65
|
+
|---|---|
|
|
66
|
+
|`String`|The value|
|
|
67
|
+
|
|
68
|
+
### `public virtual String overridableMethod()`
|
|
69
|
+
|
|
70
|
+
*Inherited*
|
|
71
|
+
|
|
51
72
|
### `public override String overridableMethodOverridden()`
|
|
52
73
|
|
|
53
74
|
This method was overridden.
|
|
@@ -73,22 +94,4 @@ sequenceDiagram
|
|
|
73
94
|
```
|
|
74
95
|
|
|
75
96
|
|
|
76
|
-
### `public void execute()`
|
|
77
|
-
|
|
78
|
-
Executes the command.
|
|
79
|
-
|
|
80
|
-
### `public String getValue()`
|
|
81
|
-
|
|
82
|
-
Returns a value based on the executed command.
|
|
83
|
-
|
|
84
|
-
#### Returns
|
|
85
|
-
|
|
86
|
-
|Type|Description|
|
|
87
|
-
|---|---|
|
|
88
|
-
|`String`|The value|
|
|
89
|
-
|
|
90
|
-
### `public virtual String overridableMethod()`
|
|
91
|
-
|
|
92
|
-
*Inherited*
|
|
93
|
-
|
|
94
97
|
---
|
|
@@ -62,23 +62,23 @@ Constructs a SampleClass with an argument.
|
|
|
62
62
|
## Fields
|
|
63
63
|
### Common Constants
|
|
64
64
|
|
|
65
|
-
* `public ANOTHER_CONSTANT` → `String`
|
|
66
65
|
* `public A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
|
|
66
|
+
* `public ANOTHER_CONSTANT` → `String`
|
|
67
67
|
* `public listOfStrings` → `List<String>`
|
|
68
68
|
---
|
|
69
69
|
### 'General' Constants
|
|
70
70
|
|
|
71
|
-
* `public GENERAL_ANOTHER_CONSTANT` → `String`
|
|
72
71
|
* `public GENERAL_A_CONSTANT` → `String` [`NAMESPACEACCESSIBLE` ] - This is a constant.
|
|
73
|
-
|
|
74
|
-
### Other variables
|
|
75
|
-
|
|
76
|
-
* `public someVariable` → `String`
|
|
72
|
+
* `public GENERAL_ANOTHER_CONSTANT` → `String`
|
|
77
73
|
---
|
|
78
74
|
### Other
|
|
79
75
|
|
|
80
76
|
* `private somePrivateStuff` → `String`
|
|
81
77
|
---
|
|
78
|
+
### Other variables
|
|
79
|
+
|
|
80
|
+
* `public someVariable` → `String`
|
|
81
|
+
---
|
|
82
82
|
## Properties
|
|
83
83
|
|
|
84
84
|
### `public AnotherProp` → `Decimal`
|
|
@@ -97,6 +97,13 @@ This is a String property.
|
|
|
97
97
|
---
|
|
98
98
|
## Methods
|
|
99
99
|
### A method group
|
|
100
|
+
##### `public static String anotherSampleMethod(String arg1)`
|
|
101
|
+
|
|
102
|
+
Something here
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
**Arg1** The arg1 description
|
|
106
|
+
|
|
100
107
|
##### `public static String sampleMethod(String argument1, String argument2)`
|
|
101
108
|
|
|
102
109
|
`NAMESPACEACCESSIBLE`
|
|
@@ -123,13 +130,6 @@ System.debug(result);
|
|
|
123
130
|
```
|
|
124
131
|
|
|
125
132
|
|
|
126
|
-
##### `public static String anotherSampleMethod(String arg1)`
|
|
127
|
-
|
|
128
|
-
Something here
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
**Arg1** The arg1 description
|
|
132
|
-
|
|
133
133
|
##### `public static Map<Id,List<String>> yetAnotherSampleMethod(String arg1)`
|
|
134
134
|
---
|
|
135
135
|
### Other
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @description Some desc
|
|
3
|
-
* @group Classes
|
|
4
|
-
* @mermaid
|
|
5
|
-
* sequenceDiagram
|
|
6
|
-
* participant dotcom
|
|
7
|
-
* participant iframe
|
|
8
|
-
* participant viewscreen
|
|
9
|
-
* dotcom->>iframe: loads html w/ iframe url
|
|
10
|
-
* iframe->>viewscreen: request template
|
|
11
|
-
* viewscreen->>iframe: html & javascript
|
|
12
|
-
* iframe->>dotcom: iframe ready
|
|
13
|
-
* dotcom->>iframe: set mermaid data on iframe
|
|
14
|
-
* iframe->>iframe: render mermaid
|
|
15
|
-
*/
|
|
16
|
-
public interface AnotherInterface{}
|
|
1
|
+
/**
|
|
2
|
+
* @description Some desc
|
|
3
|
+
* @group Classes
|
|
4
|
+
* @mermaid
|
|
5
|
+
* sequenceDiagram
|
|
6
|
+
* participant dotcom
|
|
7
|
+
* participant iframe
|
|
8
|
+
* participant viewscreen
|
|
9
|
+
* dotcom->>iframe: loads html w/ iframe url
|
|
10
|
+
* iframe->>viewscreen: request template
|
|
11
|
+
* viewscreen->>iframe: html & javascript
|
|
12
|
+
* iframe->>dotcom: iframe ready
|
|
13
|
+
* dotcom->>iframe: set mermaid data on iframe
|
|
14
|
+
* iframe->>iframe: render mermaid
|
|
15
|
+
*/
|
|
16
|
+
public interface AnotherInterface{}
|
|
@@ -1,41 +1,42 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @description Some desc
|
|
3
|
-
* @group Classes
|
|
4
|
-
*/
|
|
5
|
-
public class ChildClass extends ParentClass implements SampleInterface {
|
|
6
|
-
private String privateStringFromChild;
|
|
7
|
-
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
* @
|
|
15
|
-
* @
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
* participant
|
|
19
|
-
* participant
|
|
20
|
-
*
|
|
21
|
-
* iframe
|
|
22
|
-
* viewscreen
|
|
23
|
-
* iframe
|
|
24
|
-
* dotcom
|
|
25
|
-
*
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
* @
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
1
|
+
/**
|
|
2
|
+
* @description Some desc
|
|
3
|
+
* @group Classes
|
|
4
|
+
*/
|
|
5
|
+
public class ChildClass extends ParentClass implements SampleInterface {
|
|
6
|
+
private String privateStringFromChild;
|
|
7
|
+
private String aPrivateString;
|
|
8
|
+
|
|
9
|
+
public void doSomething() {
|
|
10
|
+
System.debug('Do something');
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
/**
|
|
14
|
+
* @description This method was overridden.
|
|
15
|
+
* @return A String.
|
|
16
|
+
* @mermaid
|
|
17
|
+
* sequenceDiagram
|
|
18
|
+
* participant dotcom
|
|
19
|
+
* participant iframe
|
|
20
|
+
* participant viewscreen
|
|
21
|
+
* dotcom->>iframe: loads html w/ iframe url
|
|
22
|
+
* iframe->>viewscreen: request template
|
|
23
|
+
* viewscreen->>iframe: html & javascript
|
|
24
|
+
* iframe->>dotcom: iframe ready
|
|
25
|
+
* dotcom->>iframe: set mermaid data on iframe
|
|
26
|
+
* iframe->>iframe: render mermaid
|
|
27
|
+
*/
|
|
28
|
+
public override String overridableMethodOverridden() {
|
|
29
|
+
return null ?? '';
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* @description Executes the command.
|
|
34
|
+
*/
|
|
35
|
+
public void execute();
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* @description Returns a value based on the executed command.
|
|
39
|
+
* @return The value
|
|
40
|
+
*/
|
|
41
|
+
public String getValue();
|
|
42
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @description This sentence has an `@embedded` annotation.
|
|
3
|
-
*/
|
|
4
|
-
public with sharing class EscapedAnnotations {
|
|
5
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* @description This sentence has an `@embedded` annotation.
|
|
3
|
+
*/
|
|
4
|
+
public with sharing class EscapedAnnotations {
|
|
5
|
+
}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
|
-
public virtual class GrandparentClass {
|
|
2
|
-
protected String protectedGrandParentField;
|
|
3
|
-
|
|
4
|
-
protected String AProp { get; set; }
|
|
1
|
+
public virtual class GrandparentClass {
|
|
2
|
+
protected String protectedGrandParentField;
|
|
3
|
+
|
|
4
|
+
protected String AProp { get; set; }
|
|
5
5
|
}
|
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
/**********************************************************
|
|
2
|
-
Uses a block style apex doc
|
|
3
|
-
@group Main
|
|
4
|
-
@test-class {@link SampleClass}
|
|
5
|
-
***********************************************************/
|
|
6
|
-
public class GroupedClass {
|
|
7
|
-
|
|
8
|
-
}
|
|
1
|
+
/**********************************************************
|
|
2
|
+
Uses a block style apex doc
|
|
3
|
+
@group Main
|
|
4
|
+
@test-class {@link SampleClass}
|
|
5
|
+
***********************************************************/
|
|
6
|
+
public class GroupedClass {
|
|
7
|
+
|
|
8
|
+
}
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
public class MemberGrouping {
|
|
2
|
-
// @start-group Group old syntax
|
|
3
|
-
public static final String inGroup1;
|
|
4
|
-
public static final String anotherInGroup1;
|
|
5
|
-
// @end-group
|
|
6
|
-
|
|
7
|
-
/**
|
|
8
|
-
* @start-group Group new syntax
|
|
9
|
-
* @description Group's description
|
|
10
|
-
*/
|
|
11
|
-
|
|
12
|
-
/** @description Description for constant in group 2 */
|
|
13
|
-
public static final String inGroup2;
|
|
14
|
-
/** @description Description for another constant in group 2 @future annotation */
|
|
15
|
-
public static final String anotherInGroup2;
|
|
16
|
-
/** @end-group */
|
|
17
|
-
}
|
|
1
|
+
public class MemberGrouping {
|
|
2
|
+
// @start-group Group old syntax
|
|
3
|
+
public static final String inGroup1;
|
|
4
|
+
public static final String anotherInGroup1;
|
|
5
|
+
// @end-group
|
|
6
|
+
|
|
7
|
+
/**
|
|
8
|
+
* @start-group Group new syntax
|
|
9
|
+
* @description Group's description
|
|
10
|
+
*/
|
|
11
|
+
|
|
12
|
+
/** @description Description for constant in group 2 */
|
|
13
|
+
public static final String inGroup2;
|
|
14
|
+
/** @description Description for another constant in group 2 @future annotation */
|
|
15
|
+
public static final String anotherInGroup2;
|
|
16
|
+
/** @end-group */
|
|
17
|
+
}
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
public abstract class ParentClass extends GrandparentClass{
|
|
2
|
-
private String privateStringFromParent;
|
|
3
|
-
/**
|
|
4
|
-
* @description This is a protected string, use carefully.
|
|
5
|
-
*/
|
|
6
|
-
protected String protectedStringFromParent;
|
|
7
|
-
public String publicStringFromParent;
|
|
8
|
-
|
|
9
|
-
public virtual String overridableMethod() {
|
|
10
|
-
return '';
|
|
11
|
-
}
|
|
12
|
-
|
|
13
|
-
public virtual String overridableMethodOverridden() {
|
|
14
|
-
return '';
|
|
15
|
-
}
|
|
16
|
-
}
|
|
1
|
+
public abstract class ParentClass extends GrandparentClass{
|
|
2
|
+
private String privateStringFromParent;
|
|
3
|
+
/**
|
|
4
|
+
* @description This is a protected string, use carefully.
|
|
5
|
+
*/
|
|
6
|
+
protected String protectedStringFromParent;
|
|
7
|
+
public String publicStringFromParent;
|
|
8
|
+
|
|
9
|
+
public virtual String overridableMethod() {
|
|
10
|
+
return '';
|
|
11
|
+
}
|
|
12
|
+
|
|
13
|
+
public virtual String overridableMethodOverridden() {
|
|
14
|
+
return '';
|
|
15
|
+
}
|
|
16
|
+
}
|
|
@@ -1,166 +1,166 @@
|
|
|
1
|
-
/**
|
|
2
|
-
* @description This is a class description. This class relates to {@link SampleInterface}
|
|
3
|
-
* But this {@link ClassThatDoesNotExist} does not exist.
|
|
4
|
-
* You can also link using this syntax <<SampleInterface>>
|
|
5
|
-
* @group Main
|
|
6
|
-
* @CustomAnnotation A Custom annotation
|
|
7
|
-
* @author Cesar Parra
|
|
8
|
-
* @see SampleInterface
|
|
9
|
-
*/
|
|
10
|
-
@NamespaceAccessible
|
|
11
|
-
public virtual with sharing class SampleClass {
|
|
12
|
-
/**
|
|
13
|
-
* @description This is a namespace accessible enum
|
|
14
|
-
*/
|
|
15
|
-
@NamespaceAccessible
|
|
16
|
-
public enum InnerEnum {
|
|
17
|
-
A,
|
|
18
|
-
B,
|
|
19
|
-
C
|
|
20
|
-
}
|
|
21
|
-
|
|
22
|
-
// @start-group Common Constants
|
|
23
|
-
|
|
24
|
-
public List<String> listOfStrings;
|
|
25
|
-
|
|
26
|
-
/**
|
|
27
|
-
* @description This is a constant.
|
|
28
|
-
*/
|
|
29
|
-
@NamespaceAccessible
|
|
30
|
-
public static final String A_CONSTANT = 'My Constant Value';
|
|
31
|
-
public static final String ANOTHER_CONSTANT = 'My Constant Value';
|
|
32
|
-
// @end-group
|
|
33
|
-
|
|
34
|
-
// @start-group 'General' Constants
|
|
35
|
-
/**
|
|
36
|
-
* @description This is a constant.
|
|
37
|
-
*/
|
|
38
|
-
@NamespaceAccessible
|
|
39
|
-
public static final String GENERAL_A_CONSTANT = 'My Constant Value';
|
|
40
|
-
public static final String GENERAL_ANOTHER_CONSTANT = 'My Constant Value';
|
|
41
|
-
// @end-group
|
|
42
|
-
|
|
43
|
-
// @start-group Other variables
|
|
44
|
-
public String someVariable = 'test';
|
|
45
|
-
// @end-group
|
|
46
|
-
|
|
47
|
-
// @start-group My Super Group
|
|
48
|
-
/**
|
|
49
|
-
* @description Constructs a SampleClass without any arguments. This relates to {@link SampleInterface}
|
|
50
|
-
* @throws ExcName some exception
|
|
51
|
-
* @CustomAnnotation A Custom method annotation
|
|
52
|
-
* @see SampleInterface
|
|
53
|
-
* @example
|
|
54
|
-
* // Example
|
|
55
|
-
* SampleClass sampleInstance = new SampleClass();
|
|
56
|
-
*/
|
|
57
|
-
@NamespaceAccessible
|
|
58
|
-
public SampleClass() {
|
|
59
|
-
System.debug('Constructor');
|
|
60
|
-
}
|
|
61
|
-
// @end-group
|
|
62
|
-
|
|
63
|
-
/**
|
|
64
|
-
* @description Constructs a SampleClass with an argument.
|
|
65
|
-
* @param argument1 Argument1 definition
|
|
66
|
-
* @param argument2 Argument2 definition
|
|
67
|
-
*/
|
|
68
|
-
public SampleClass(String argument1, String argument2) {
|
|
69
|
-
System.debug('Constructor');
|
|
70
|
-
}
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
// @start-group A method group
|
|
74
|
-
/**
|
|
75
|
-
* @description Executes commands based on the passed in argument.
|
|
76
|
-
* @example
|
|
77
|
-
* String result = SampleClass.testMethod();
|
|
78
|
-
* System.debug(result);
|
|
79
|
-
* @param argument1 Argument1 to debug
|
|
80
|
-
* @param argument2 Argument2 to debug
|
|
81
|
-
* @return Empty string
|
|
82
|
-
*/
|
|
83
|
-
@NamespaceAccessible
|
|
84
|
-
public static String sampleMethod(String argument1, String argument2) {
|
|
85
|
-
System.debug('Execute');
|
|
86
|
-
return '';
|
|
87
|
-
}
|
|
88
|
-
|
|
89
|
-
/**
|
|
90
|
-
* @description Something here
|
|
91
|
-
* @arg1 The arg1 description
|
|
92
|
-
*/
|
|
93
|
-
public static String anotherSampleMethod(String arg1) {
|
|
94
|
-
System.debug('something');
|
|
95
|
-
return '';
|
|
96
|
-
}
|
|
97
|
-
|
|
98
|
-
public static Map<Id, List<String>> yetAnotherSampleMethod(String arg1) {
|
|
99
|
-
System.debug('something');
|
|
100
|
-
return new Map<Id, List<String>>();
|
|
101
|
-
}
|
|
102
|
-
// @end-group
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
/**
|
|
106
|
-
* @description Calls the method.
|
|
107
|
-
* This methods allows you to call it.
|
|
108
|
-
*/
|
|
109
|
-
public static void call() {
|
|
110
|
-
}
|
|
111
|
-
|
|
112
|
-
/**
|
|
113
|
-
* @description This is a String property.
|
|
114
|
-
*/
|
|
115
|
-
@AuraEnabled
|
|
116
|
-
@Deprecated
|
|
117
|
-
public String MyProp { get; set; }
|
|
118
|
-
|
|
119
|
-
/**
|
|
120
|
-
* @description This is a Decimal property.
|
|
121
|
-
*/
|
|
122
|
-
@AuraEnabled
|
|
123
|
-
public Decimal AnotherProp { get; private set; }
|
|
124
|
-
|
|
125
|
-
private String somePrivateStuff;
|
|
126
|
-
|
|
127
|
-
/**
|
|
128
|
-
* @description Inner class belonging to SampleClass.
|
|
129
|
-
*/
|
|
130
|
-
public class InnerClass {
|
|
131
|
-
/**
|
|
132
|
-
* @description Description of the inner property.
|
|
133
|
-
*/
|
|
134
|
-
public String InnerProp {
|
|
135
|
-
get;
|
|
136
|
-
set;
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
/**
|
|
140
|
-
* @description Executes from the inner class.
|
|
141
|
-
*/
|
|
142
|
-
public void innerMethod() {
|
|
143
|
-
System.debug('Executing inner method.');
|
|
144
|
-
}
|
|
145
|
-
}
|
|
146
|
-
|
|
147
|
-
/**
|
|
148
|
-
* @description Inner class belonging to SampleClass.
|
|
149
|
-
*/
|
|
150
|
-
public class AnotherInnerClass {
|
|
151
|
-
/**
|
|
152
|
-
* @description Description of the inner property.
|
|
153
|
-
*/
|
|
154
|
-
public String InnerProp {
|
|
155
|
-
get;
|
|
156
|
-
set;
|
|
157
|
-
}
|
|
158
|
-
|
|
159
|
-
/**
|
|
160
|
-
* @description Executes from the inner class.
|
|
161
|
-
*/
|
|
162
|
-
public void innerMethod() {
|
|
163
|
-
System.debug('Executing inner method.');
|
|
164
|
-
}
|
|
165
|
-
}
|
|
166
|
-
}
|
|
1
|
+
/**
|
|
2
|
+
* @description This is a class description. This class relates to {@link SampleInterface}
|
|
3
|
+
* But this {@link ClassThatDoesNotExist} does not exist.
|
|
4
|
+
* You can also link using this syntax <<SampleInterface>>
|
|
5
|
+
* @group Main
|
|
6
|
+
* @CustomAnnotation A Custom annotation
|
|
7
|
+
* @author Cesar Parra
|
|
8
|
+
* @see SampleInterface
|
|
9
|
+
*/
|
|
10
|
+
@NamespaceAccessible
|
|
11
|
+
public virtual with sharing class SampleClass {
|
|
12
|
+
/**
|
|
13
|
+
* @description This is a namespace accessible enum
|
|
14
|
+
*/
|
|
15
|
+
@NamespaceAccessible
|
|
16
|
+
public enum InnerEnum {
|
|
17
|
+
A,
|
|
18
|
+
B,
|
|
19
|
+
C
|
|
20
|
+
}
|
|
21
|
+
|
|
22
|
+
// @start-group Common Constants
|
|
23
|
+
|
|
24
|
+
public List<String> listOfStrings;
|
|
25
|
+
|
|
26
|
+
/**
|
|
27
|
+
* @description This is a constant.
|
|
28
|
+
*/
|
|
29
|
+
@NamespaceAccessible
|
|
30
|
+
public static final String A_CONSTANT = 'My Constant Value';
|
|
31
|
+
public static final String ANOTHER_CONSTANT = 'My Constant Value';
|
|
32
|
+
// @end-group
|
|
33
|
+
|
|
34
|
+
// @start-group 'General' Constants
|
|
35
|
+
/**
|
|
36
|
+
* @description This is a constant.
|
|
37
|
+
*/
|
|
38
|
+
@NamespaceAccessible
|
|
39
|
+
public static final String GENERAL_A_CONSTANT = 'My Constant Value';
|
|
40
|
+
public static final String GENERAL_ANOTHER_CONSTANT = 'My Constant Value';
|
|
41
|
+
// @end-group
|
|
42
|
+
|
|
43
|
+
// @start-group Other variables
|
|
44
|
+
public String someVariable = 'test';
|
|
45
|
+
// @end-group
|
|
46
|
+
|
|
47
|
+
// @start-group My Super Group
|
|
48
|
+
/**
|
|
49
|
+
* @description Constructs a SampleClass without any arguments. This relates to {@link SampleInterface}
|
|
50
|
+
* @throws ExcName some exception
|
|
51
|
+
* @CustomAnnotation A Custom method annotation
|
|
52
|
+
* @see SampleInterface
|
|
53
|
+
* @example
|
|
54
|
+
* // Example
|
|
55
|
+
* SampleClass sampleInstance = new SampleClass();
|
|
56
|
+
*/
|
|
57
|
+
@NamespaceAccessible
|
|
58
|
+
public SampleClass() {
|
|
59
|
+
System.debug('Constructor');
|
|
60
|
+
}
|
|
61
|
+
// @end-group
|
|
62
|
+
|
|
63
|
+
/**
|
|
64
|
+
* @description Constructs a SampleClass with an argument.
|
|
65
|
+
* @param argument1 Argument1 definition
|
|
66
|
+
* @param argument2 Argument2 definition
|
|
67
|
+
*/
|
|
68
|
+
public SampleClass(String argument1, String argument2) {
|
|
69
|
+
System.debug('Constructor');
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
|
|
73
|
+
// @start-group A method group
|
|
74
|
+
/**
|
|
75
|
+
* @description Executes commands based on the passed in argument.
|
|
76
|
+
* @example
|
|
77
|
+
* String result = SampleClass.testMethod();
|
|
78
|
+
* System.debug(result);
|
|
79
|
+
* @param argument1 Argument1 to debug
|
|
80
|
+
* @param argument2 Argument2 to debug
|
|
81
|
+
* @return Empty string
|
|
82
|
+
*/
|
|
83
|
+
@NamespaceAccessible
|
|
84
|
+
public static String sampleMethod(String argument1, String argument2) {
|
|
85
|
+
System.debug('Execute');
|
|
86
|
+
return '';
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/**
|
|
90
|
+
* @description Something here
|
|
91
|
+
* @arg1 The arg1 description
|
|
92
|
+
*/
|
|
93
|
+
public static String anotherSampleMethod(String arg1) {
|
|
94
|
+
System.debug('something');
|
|
95
|
+
return '';
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
public static Map<Id, List<String>> yetAnotherSampleMethod(String arg1) {
|
|
99
|
+
System.debug('something');
|
|
100
|
+
return new Map<Id, List<String>>();
|
|
101
|
+
}
|
|
102
|
+
// @end-group
|
|
103
|
+
|
|
104
|
+
|
|
105
|
+
/**
|
|
106
|
+
* @description Calls the method.
|
|
107
|
+
* This methods allows you to call it.
|
|
108
|
+
*/
|
|
109
|
+
public static void call() {
|
|
110
|
+
}
|
|
111
|
+
|
|
112
|
+
/**
|
|
113
|
+
* @description This is a String property.
|
|
114
|
+
*/
|
|
115
|
+
@AuraEnabled
|
|
116
|
+
@Deprecated
|
|
117
|
+
public String MyProp { get; set; }
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* @description This is a Decimal property.
|
|
121
|
+
*/
|
|
122
|
+
@AuraEnabled
|
|
123
|
+
public Decimal AnotherProp { get; private set; }
|
|
124
|
+
|
|
125
|
+
private String somePrivateStuff;
|
|
126
|
+
|
|
127
|
+
/**
|
|
128
|
+
* @description Inner class belonging to SampleClass.
|
|
129
|
+
*/
|
|
130
|
+
public class InnerClass {
|
|
131
|
+
/**
|
|
132
|
+
* @description Description of the inner property.
|
|
133
|
+
*/
|
|
134
|
+
public String InnerProp {
|
|
135
|
+
get;
|
|
136
|
+
set;
|
|
137
|
+
}
|
|
138
|
+
|
|
139
|
+
/**
|
|
140
|
+
* @description Executes from the inner class.
|
|
141
|
+
*/
|
|
142
|
+
public void innerMethod() {
|
|
143
|
+
System.debug('Executing inner method.');
|
|
144
|
+
}
|
|
145
|
+
}
|
|
146
|
+
|
|
147
|
+
/**
|
|
148
|
+
* @description Inner class belonging to SampleClass.
|
|
149
|
+
*/
|
|
150
|
+
public class AnotherInnerClass {
|
|
151
|
+
/**
|
|
152
|
+
* @description Description of the inner property.
|
|
153
|
+
*/
|
|
154
|
+
public String InnerProp {
|
|
155
|
+
get;
|
|
156
|
+
set;
|
|
157
|
+
}
|
|
158
|
+
|
|
159
|
+
/**
|
|
160
|
+
* @description Executes from the inner class.
|
|
161
|
+
*/
|
|
162
|
+
public void innerMethod() {
|
|
163
|
+
System.debug('Executing inner method.');
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
}
|