blob: ad1d53a6d19465ed99d06abe27c54de036d4637c (
plain) (
blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
|
/*******************************************************************************
* Copyright (c) 2012 protos software gmbh (http://www.protos.de).
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* CONTRIBUTORS:
* Thomas Schuetz (initial contribution)
*
*******************************************************************************/
package org.eclipse.etrice.generator.generic;
import org.eclipse.etrice.core.room.DataType;
import org.eclipse.etrice.core.room.EnumLiteral;
import org.eclipse.etrice.core.room.EnumerationType;
import org.eclipse.etrice.core.room.PrimitiveType;
import org.eclipse.etrice.generator.fsm.generic.ILanguageExtensionBase;
/**
* This interface is used to achieve target language independence of the
* generic generator parts such as the {@link GenericActorClassGenerator},
* the {@link GenericProtocolClassGenerator} and the {@link GenericStateMachineGenerator}.
*
* @author Thomas Schuetz
* @author Henrik Rentz-Reichert
*/
public interface ILanguageExtension extends ILanguageExtensionBase {
/**
* Produces necessary casts or data type keys for an attribute (array) value statement
* @param type ROOM PrimitiveType
* @param value User value statement, maybe array (with)out brackets
* @return for Java: <br>
* toPrimitve("PrimitiveType int64: ptInteger -> long (Long)", Long value = 99) -> 99L<br>
* toPrimitve("PrimitiveType int8: ptInteger -> byte (Byte)", Byte value = 12) -> (byte)12
*/
String toValueLiteral(PrimitiveType type, String value);
/**
* User enum value to platform expression
* @param type ROOM EnumerationType
* @param value User value statement, maybe array (with)out brackets
* @return enum text expression
*/
String toEnumLiteral(EnumerationType type, String value);
/**
* returns a default value for a type
* @param dt the data type
* @return the default value string
*/
String defaultValue(DataType dt);
/**
* returns an initializer for an array with default values
* @param dt the data type
* @param size
* @return the array initializer
*/
String initializationWithDefaultValues(DataType dt, int size);
/**
* returns the target type for the enumeration type
* @param type the enumeration type
* @return the target type for the enumeration type
*/
String getTargetType(EnumerationType type);
/**
* returns the casted value as string
* @param literal an enumeration type literal
* @return the casted value as string
*/
String getCastedValue(EnumLiteral literal);
/**
* return the cast type of an enumeration type
* @param type the enumeration type
* @return the cast type of an enumeration type
*/
String getCastType(EnumerationType type);
}
|