Parse::Dia::SQL::Utils(3)

NAME
Parse::Dia::SQL::Utils - Helper class for Parse::Dia::SQL.

SYNOPSIS
  Not to be used directly.

DESCRIPTION
Utility functions for Parse::Dia::SQL.

  set_default_pk
Define primary key column names and types for automatic generation of primary keys in tables that need them, but do not have them defined.

  new
The constructor. No arguments.

  new

  get_node_attribute_values
Given a node with dia:attribute nodes inside it, go through the dia:attribute nodes with attribute "name='...'" and return the string values

@infosToGet is an array of strings, where the first character is the data type to get, and the remaining characters are the name to parse for. first character legal values are:

   a = alpha
   9 = numeric
   b = boolean

example: aname, 9dollars, bkillOrNot

  get_string_from_node
If it looks like <thingy><dia:string>value</dia:string></thingy> then we will get the 'value' part out given the node is 'thingy'.

  get_value_from_object
Given an object, node name, attribute name, attribute value, and value to retrieve type, find the info and return it.

  get_node_from_object
Given an object, node name, attribute name, and attribute value, return the node that has all these things.

  name_case
Transform case for name comparisons to that of the database; leave unchanged if -C (preserve case) is in effect. Only sybase is known to be case sensitive.

  get_num_from_node
Return value part of <dia:enum val="value"></thingy>.

  get_bool_from_node
Return value part of <thingy><dia:boolean val="value"></thingy>.

  classify_multiplicity
Look at a multiplicity descriptor and classify it as 'one' (1, or 1..1), 'zone' (0..1), 'many' (n..m, n..*, where n > 1, m >= n) and 'zmany' (0..n, 0..*, where n > 1)

  attlist_from_names
Generate a list of attributes from a comma-separated list of names by looking up a class' attribute table.

  names_from_attlist
Generate a comma-separated list of attribute names from a list of attributes.

  check_att_list_types
Check that a list of primary key attributes has types corresponding to the types in a list of foreign key attributes

  get_base_type
Check that a list of primary key attributes has types corresponding to the types in a list of foreign key attributes.

Returns base type of some DMBS specific types (eg in PostgreSQL serial is integer).

AFF note: This is better implemented in each sql formatter class.

  make_name
Generate a longer name from parts supplied. Except for the first part, the first letter of each part is capitalised. If lcFirstWord is set, then any initial string of capitals in the first part is made lower case; otherwise the first part is left unchanged.

Dies if $self->{db} is not set.

The @parts_org values are save for "Desperation time" :)

  name_scramble
PSuda: Name scrambling helper function, for code which auto-generates names. Takes one arg, which is string to use for md5 hashing. This returns names which consist entirely of underscores and alphanumeric characters, and starts with one or more alpha characters.

  mangle_name
Get a name to mangle and mangle it to the length specified -- avoid too much manglification if the name is only slightly long, but mangle lots if it's a lot longer than the specified length.

  add_default_pk
For -p - add a default primary key to a parsed table definition

TODO : Add a meaningful return value.

  add_default_fk
For -f - add missing parts of a default foreign key to a parsed table definition.